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HOW CAN CIVICRM HELP YOU? 



CiviCRM will help whether you are starting off on a new project or whether you are wanting to 
better harness the mountain of information held by your non-profit. You can use it to achieve 
more, grow more, communicate better and make better decisions. 

ACHIEVE MORE 

CiviCRM gives you the tools you need to easily capture information about your contacts, 
organise that information and put it to use. Additional functionality to manage events, 
membership drives, and fund-raising campaigns means you can spend less time on 
administration and more on your mission. 

CiviCRM's event management framework provides a set of tools to manage events from start 
to finish. It integrates with your website for publicity and online bookings, and can 
automatically syndicate event information to other sources. Out-of-the-box integration with a 
range of payment processors allows your constituents to register and pay immediately online 
(and you can also process registrations offline if you or your constituents prefer). When the 
event is over, you are left with a complete record of attendance linked to each contact's 
personal record. 

CiviCRM provides an automated online sign-up and renewal process, which is flexible and 
configurable to match virtually any non-profit's membership model (including yearly 
membership, 'rolling renewals', different membership prices and automatic renewals). It is also 
designed for offline membership processing. 

EARN MORE 

CiviCRM has a sophisticated finance and fundraising framework, designed to make it as easy 
as possible for people to donate to you and for you to keep track of donations. 

Create online campaign pages and send personalised emails that link to pre-filled forms for one 
click donations. Leverage social networks and let your supporters fundraise for you with 
Personal Campaign Pages linked to your organisation's campaigns - you get the donations and 
they get the kudos. You can also set up automated recurring payments to ensure you make 
the most out of your loyal supporters. 

CiviCRM also provides an at-a-glance overview of all 'money in', whether it is from campaigns, 
membership drives, events, or other sources, enabling you to see who has donated as a result 
of what form of engagement. You can quickly generate reports about who is responding to 
specific campaigns and messages, enabling you to develop more effective campaigns. 

COMMUNICATE BETTER 

Good communication is all about knowing your constituents. An integrated, historical record of 
interactions with each constituent means you have detailed knowledge that you can use when 
you talk to them on an individual basis. 

CiviCRM lets you harness all the knowledge you have about your constituents to generate 
personalised mass mailings, for example: 

• a mail to all contacts who didn't attend an event in the last year encouraging them to 
re-engage with the organisation 

• a printed letter to members that donated more than a specified amount to recognise 
their contribution to your organisation. 

Communication is a two-way process. In any online interaction with clients, CiviCRM gives you 
the opportunity to ask them questions either to collect information or to increase their 
engagement with you. You can encourage them to volunteer more information, change to 



monthly giving, or make a special contribution to your current campaign. 

MAKE BETTER DECISIONS 

By managing your information, CiviCRM gives you the tools you need to make better 
decisions. You can run ad hoc reports to answer specific questions, or run regular reports to 
assess the success of your work. This information can tell you how you are achieving your 
goals and help you to better target your resources. 
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FEATURES 



Depending on the activities and services your organization is involved with, CiviCRM can 
provide you with tools for donor management, memberships, event management, email and 
postal communications, tracking services and reporting. For advocacy, non-profit and non- 
governmental groups, this often adds measurable value. 

Regardless of your organization's size and requirements for your CRM solution, the goal 
remains the same: learn more about your constituents and leverage that knowledge in the 
service of your mission. CiviCRM offers the entire spectrum of all the abilities of CRM to 
engage your constituents. 

There are four main modules, all of which can be freely enabled to extend the core CRM 
functionality: 




CiviContribute: Online fundraising and donor management 

CiviContribute is an online fundraising and donor management component which enables you to 
track and manage contributions to your organization. It also allows you to quickly and easily 
create customized web pages to accept online donations. CiviContribute creates or updates 
contact and donation records for all contributions, eliminating data entry time and errors. 



CiviEvent: Online event registration and participant tracking 

CiviEvent provides integrated online event registration and management for paid and free 
events. It allows you to quickly and easily create customized web pages to for event 
registration, and then track participants. CiviEvent creates or updates contact records for all 
event participants, eliminating data entry time and errors. 




CiviMail: Personalized email blasts and newsletters 

CiviMail is a robust mass-mailing component which allows you to engage your constituents with 
personalized, trackable email blasts and newsletters. Target mailings can be targeted at 
precise groupings within your database. Messages can be personalized using mail-merge 
tokens. Tracking and reporting are built-in, and bounces and unsubscribe requests are 
managed automatically. 




CiviMember: Online signup and membership management 



CiviMember provides flexible membership management for your organization, along with 
convenient online signup and renewal. You can configure any number of membership types or 
levels for one or more organizations and/or chapters of an organization, customize 
membership statuses and rules, create customized web pages for self-service membership 
signup and renewal, search and list memberships by date, type, status and contact 
information including name and address. 



INTERNATIONALISATION 



English is an international language of information technology, but the adoption of IT 
solutions requires them to be available in various languages. Software being Internationalized 
means that a program is ready for adoption in different countries and different cultures, 
without the need to modify it technically. This is an important focus for the CiviCRM 
Development Team. It has been built with international needs in mind. 

Another term that is commonly used in this context is localization. This is basically the 
process of adapting software for a specific country or language (using its internationalization 
capabilities) by translating text displayed on the screen and introducing different region specific 
settings. These settings are (among others): 

• currency used in given country (USD or $ in United States, GBP or £ in Great Britain) 

• date and time formats (for example: November 16th, 2009 will be commonly written as 
11/16/2009 in United States, but in Russia the format will be 16.11.2009) 

• formatting of numbers (the same number will be written slightly differently in different 
countries: 1 234 567,89 in Slovakia or Hungary, but 1,234,567.89 in Japan or United 
States) 

There are other internationalization and localization concerns to be taken into consideration 
when using software. 

When reading about internationalization, you might sometimes run over the cryptic i18n 
acronym (well, numeronym, to be strict). This term resulted from a somewhat humorous, but 
very convenient shortening of the long word - there is exactly 18 characters in between first 
and last letter of 'internationalization'. Even more humorously, given it is much shorter, the 
word localization is sometimes written as L10n. Let's not overlook the fact that these words 
are both usually spelled with a 'z' which is not a universal spelling convention in the family of 
"English" languages (New Zealand English, for example, would use 's'). 

CiviCRM was built with international users in mind and it is one of the development rules to 
provide ability for different language use. It is not, however, a part of the core effort to 
provide translations. The project relies on its community when it comes to translating all the 
texts that are being displayed to a person using software. 
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Languages 

Afrikaans, Arabic, Australian English, Brazilian Portuguese, British 
English, Bulgarian, Canadian French, Catalan, Chinese (simplified), 
Chinese- (traditional), Czech, Danish, Dutch, Estonian, Finnish, French, 
German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Italian, 
Japanese, Khmer, Lithuanian, Norwegian, PoJlsftp Portuguese, 
Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, Templates, 
Templates, Thai, Turkish, Ukrainian, Vietnamese' 



Projects 

CIviCftH 3,0, CiviCRM 3,1 
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CiviCRM translations server - http://translations.civicrm.org/ 



FURTHER READING 

Internationalization and localization 

http://en.wikipedia.org/wiki/H8n 



REAL WORLD EXAMPLES 



CiviCRM is used by all shapes and sizes of organisations that are located all over the world. 
Some have no paid employees while others might have several hundred. Their needs range 
from very simple to fairly complex. In this chapter, we will have a look at some real world 
examples of how some organisations are using CiviCRM. 

WWOOF UK 

WWOOF (World Wide Opportunities on Organic Farms) UK places volunteers on organic farms 
where they can learn about organic agriculture in exchange for food and accommodation. They 
list 400 farms in the UK and have approximately 3000 volunteers annually. Before starting 
with CiviCRM, they used a number of different offline systems to process memberships. For 
example: People sent in paper application forms and volunteers were sent a printed directory 
of the farms. 

What They Did 

They used CiviMember, integrated with a payment processor and Drupal, to allow people to 
sign-up online to become members and to pay online using a credit card (or later with cheque 
or cash). They also used CiviCRM Profiles to create an online searchable directory of contacts 
and, using Drupal's CiviMember Roles module, they were able to control access to this 
directory by synchronising users with their membership database. 

Since they wanted to continue to make data accessible to people that didn't use the internet, 
they used the CiviCRM admin interface to allow staff to manually process paper applications 
and, using CiviCRM's export functionality, to export data for a printed directory. 

The Results 

Simple online sign-up and instant access to the directory meant they doubled their 
membership income in the first month of implementing the new system! Staff are able to 
access the data from anywhere, which allows for much more flexible working practices and 
the ability to recruit more volunteers to help run the organisation. Membership administration 
time was reduced to zero for the majority of members that chose online access. 

What They Learned 

Transferring all office systems to CiviCRM was a 'change management' challenge! - and was 
more than they had anticipated. If they were to do it again, they would try split the process 
up, perhaps putting the directory online before switching to CiviCRM for online sign-up. They 
also underestimated the amount of training that was needed on the new system and would 
plan more time for testing and getting used to the system before 'going live'. 

WELLINGTON CIRCUS TRUST 
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This example shows how clubs can use CiviCRM for summer camps, sports clubs, dance 
classes and other events. 



Wellington Circus Trust is run entirely by volunteers. They have a mailing list of 500-600 
people and run blocks of classes in circus skills such as trapeze and hula hoop. They also host 
events. For safety reasons the Trust needs to gather information about who to contact in the 
case of a student being injured. The Trust processes about 200 enrollments a year. 

Prior to using CiviCRM, the trust maintained a Microsoft Access database, but data entry was 
time consuming, keeping information up-to-date was difficult and emailing the resulting contact 
information on a regular basis to the tutors, was challenging. The treasurer wanted people to 
be able to maintain their own details and wanted the tutors and volunteers to be able to 
access people's contact details from anywhere. 

What They Did 

After some research WCT realised CiviCRM could do the things they needed. 

Using the CiviEvents modules they set up online enrollment for the classes. This decision led to 
another, which was to pay a commission to a payment processing company so that credit 
cards could be used for online enrollment in classes. They also used CiviEvent to set limits on 
the number of students that could enroll in a given class. 

In order to track emergency contact information, they created custom data fields that were 
added to a profile that was used as a form for event registration. This information was then 
stored in CiviCRM. 

They integrated CiviCRM with Drupal and set up user accounts for every contact in their 
database and then instructed people on how to use the Drupal 'reset my password' link to 
gain access to the system for the first time. 

Once CiviCRM was installed and running the WCT decided to implement CiviMail. 

Since Wellington Circus Trust applies for grants from funding bodies, the last thing they decided 
to implement was the CiviGrants module. 

The Results 

Simply by implementing CiviCRM, tutors and volunteers could access information from 
anywhere in the world where they had Internet connectivity. 

By implementing CiviEvent in the way that they did, people were able to enroll in and pay for 
classes online and to provide their emergency contact information while doing so. By allowing 
people to sign-up online, data entry was greatly reduced. 

By integrating CiviCRM with Drupal and setting up user accounts, people were able to maintain 
and update their own contact information, which greatly reduced administration time. 

Implementing CiviMail made it very easy for them to email the tutors, volunteers and 
students. It also removed the administrative burden of manually updating the mailing list and 
contact information because CiviCRM automates all of that by allowing people to do it for 
themselves. The treasurer also found that it saved her from having hundreds of sent items in 
her outlook e-mail, which used to happen when she used Microsoft Office mail merges to send 
out newsletters. 

Prior to implementing CiviGrant, Wellington Circus Trust had not been effective at tracking the 
status of the grants. By using CiviGrant, they were able to see at a glance, what grant 
applications had been sent and the status of each grant. 

All up Linda estimated that installing CiviCRM saved hundreds of volunteer hours over the 
course of a year. 

What They Learned 



After moving to CiviCRM, WCT found that contact management and class registration were 
both easier. One issue they did find was that some people got confused about having to reset 
their Drupal passwords. WCT thinks that putting more effort into the way they explained this 
on their website would have helped. 

People found the paypal standard interface difficult to use and after six months they invested 
in developing a payment processor more appropriate to New Zealand. 

They also learned that a cheap hosting provider is not always the best option. They wasted 
quite a bit of time before they switched from a free provider to one that costs them 
approximately $NZD20 per month. 

HEALTHY ENVIRONMENT ALLIANCE OF UTAH 




HEAL Utah is a grassroots environmental organization working to protect Utahns from nuclear 
and toxic waste. Before moving to CiviCRM, they were stuck on a Microsoft Access database. 
In fact, they may have called it a database but it really was a glorified spreadsheet that made 
their day to day operations difficult. The goal for the CiviCRM project was to move to a 
system that would centralize all of their information across their organization including email 
lists, volunteer tracking, donor history and more. As an advocacy and community organizing 
organization, it is critical to their mission that they effectively engage their supporters and 
track the relationships they build with their constituency over time. They needed a tool to 
support that mission. 

What They Did 

HEAL has been using CiviCRM since the early days of the software. CiviCRM is now the central 
place to track all of their donors, volunteers, legislators, foundations and contacts. They use 
CiviCRM for donor management, email communications, event management, volunteer 
tracking, and advocacy. 

• For advocacy purposes, they track their constituents' legislative districts so that when 
issues arise that need action, they can mobilize their members on a district by district 
basis. 

• They track volunteers, the activities they participate in, and their interests. 

• For event management, they primarily hold large fundraising events that are free but 
solicit donations at the event. CiviEvent handles all of the online registrations and 
collects data such as guest names and interests. They send invitations, reminders, and 
follow-up messages via postal mail and the CiviMail component 

• CiviContribute allows them to run donor reports as well as accept online donations. 

The Results 



There is no question that CiviCRM streamlined and consolidated their data management and 
saved them valuable resources. It is interesting to note that over the last several years their 
advocacy campaigns have been more successful and their impact in their community more 
noticeable. While one cannot and should not solely credit CiviCRM for their recent successes, 
the biggest change that CiviCRM has brought to HEAL is to force them to always think about 
what role technology will play in their outreach and organizing work. 



AMERICAN FRIENDS SERVICE COMMITTEE 

The American Friends Service Committee is a large, Quaker based, peace and social justice 
organisation that has over 400 employees. Worldwide, they have programs that work to 
relieve and prevent suffering through both immediate aid and long-term development and they 
seek to serve the needs of people on all sides of violent strife. 

Their main headquarters are located in Philadelphia, Pennsylvania. They have 9 Regional 
headquarters located throughout the United States, some 50 Area offices also located in the 
US, and numerous International "field" offices located in Africa, Asia, Europe, Latin America/ 
the Caribbean and the Middle East. 

Lists of constituents are maintained by each office. Specific CRM system needs vary but, in 
general, needs are: searching for constituents that meet certain criteria, sending emails, 
newsletters, postal mail, announcements, collecting the contact information for people who 
sign on-line petitions and on-line registration for events. 

Through a survey that was conducted by the Information Technology Department at AFSC, it 
became obvious that AFSC staff were using a number of varied "systems" to keep track of 
their constituents. It also became obvious that these systems were not working: repositories 
of data were everywhere, contact information was duplicated, staff were having a hard time 
managing their contacts and the IT Department was unable to provide adequate support. 

The survey also revealed that staff were frustrated with the systems they were using 
because they lacked functionality that was necessary for them to effectively communicate 
and do outreach. Specifically: search capability was limited, there was no ability to send high- 
volume emails which meant that it was not possible to send newsletters or announcements, 
and there was no ability to collect information on-line. 

After investigating several database systems, the IT Department finally decided that, all things 
considered, CiviCRM might be the best fit for the AFSC. 

What They Did 

Initially, CiviCRM sites, that were managed by an external vendor, were established for offices 
in Los Angeles, Rhode Island, San Francisco and Seattle and CiviMail was implemented. Los 
Angeles also decided to use the CiviEvent module to track registrations for events and the 
CiviMember module to track contact information for their committee members. 

After implementation, an LA staff person discovered that certain functionality was missing 
from the CiviMember export module and this was preventing them from being able to compile 
a membership directory. AFSC talked to the CiviCRM Core development team and contracted 
them to add the missing functionality. This was a win-win situation: AFSC got the functionality 
they needed and because it was integrated back into the CiviCRM product the entire CiviCRM 
community was able to benefit from the addition. An extra advantage for AFSC is that 
because the functionality became part of CiviCRM they don't have to worry about it not being 
compatible with any future upgrades. 

The Results 

The decision to have their sites hosted and managed by an external vendor turned out not to 
be a good one because the particular vendor that was chosen ran into difficulties and was not 
responsive to issues or in providing the services that had been "promised", like timely updates 
for CiviCRM. Once the hosting issue was resolved, staff were able to take full advantage of 
the capabilities of CiviCRM, which allowed them to do all of the things that they had previously 
been unable to do. 

The Los Angeles office is in full swing, using CiviCRM as the main repository to track their 
constituents, board and committee members and volunteers. Their constituents are now able 
to sign-up for events and petitions on-line, and staff are now able to send volume emails for 
their newsletters and announcements. 



Getting rid of their old system and being able to send out their monthly newsletter was the 
main goal for the Colorado office, who came onboard with CiviCRM a little later in the process. 
They are now able to find the constituents that are to get the newsletter and to send the 
newsletter to them via CiviCRM. They couldn't be happier! 

The AFSC currently has nine CiviCRM sites and the IT Department is now recommending 
CiviCRM as the "database of choice" for its offices. Support from the CiviCRM community is 
excellent and CiviCRM itself is improving every day, with more and more functionality being 
added. AFSC staff are now able to access their data from anywhere that has internet access, 
do complex searches, on-line event registration and send online newsletters and postal 
mailings. CiviCRM is allowing them to better manage their constituents. This makes their life 
easier and in turn, is of great benefit to AFSC. 

NEW YORK STATE NURSERY LANDSCAPE ASSOCIATION 
(NYSNLA) 



NYSNLA (www.nysnla.com) is a member-based 
association providing resources and advocacy 
support for nursery and landscape professionals 
throughout New York State. The organization 
seeks to advance the interests of New York 
State's nursery and landscape businesses and 
professionals by promoting sound business 
practices, expanding state and local markets, and 
exercising leadership in the development of 
sustainable communities. 



Prior to migrating to CiviCRM the Association 
went through several iterations of member-management solutions, beginning with a series of 
spreadsheet documents and later moving to an MS Access database. The migration to CiviCRM 
was prompted by the desire to consolidate data, provide members real-time access to 
contact details, and to create a searchable member directory to site visitors who may be 
looking for a nursery or landscape professional. 




What They Did 

NYSNLA, working with a CiviCRM consultant, began the process of analyzing the structure and 
content of their existing database and mapping the various functions to CiviCRM structures. 
They determined they would use CiviMember, CiviEvent, CiviContribute, and CiviMail to address 
their core database needs, and would consider using CiviPledge at some point in the future for 
soliciting contributions to their sister non-profit, the Nurserymen's Foundation. 

One data area that required particular attention was their Certified Nursery Landscape 
Professional program (CNLP). CNLP is an intensive, on-going educational program designed to 
increase the skills of garden and landscape employees. The program was designed by 
members of the nursery and landscape industry with assistance from Cornell University. 
Interested individuals must apply to the program and successfully pass a test. The certification 
lasts two years, after which time the individual must recertify. 

NYSNLA used CiviCRM's membership functionality to track the status of CNLPs. The ability to 
define a rolling-period membership and to gauge when they are nearing expiration perfectly 
met their management needs. The initial application process, which also must be tracked 
carefully, was handled through CiviEvent, as an application to the program is essentially a 
registration to attend one of the bi-annual test events. 

The Association also took advantage of CiviCRM's open source platform to make some 
interface customizations that improved the way they looked at their records. Because of the 
importance of the CNLP program, they wanted to be able to look at all employees for a 
certain nursery /landscape company and quickly know if any of them are CNLPs or Lifetime 
CNLPs. They also needed to quickly know which employees are authorized to manage the 
company's records. Adding the membership field and an authorization icon to the relationships 
view provided them this snapshot. 
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The Results 

The Association has worked hard to communicate to the public the importance of using a 
qualified landscape professional. Essential to this effort was the inclusion of a searchable 
member directory on their website. Using CiviCRM they were able to create a search page 
that included geographic segmentation (the Association divides members into 8 regions 
statewide) and a list of services provided by members (using CiviCRM's tags feature). The 
resulting search tool, because it is directly connected with their contact data, ensures website 
visitors are always looking at current information. The Association is also able to provide 
members direct access to their contact details so they can update and maintain their list of 
services provided and other information. 
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Use the form below to search the NY3!£LA membership database. Use the region checkboxes to 
restrict the starch results based on regional area within New York State, Use the business 
classifications checkboxes to restrict the search results based on the business services provided by 

the company. Combining region and business classification checkboxes customizes the search 
further. To view all current members j click the search button without selecting any criteria, 
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GREEN PARTY OF AOTEAROA - NEW ZEALAND 

The Green Party has been the largest third party in NZ politics for most of the last decade, 
and for periods back as far as the early 1970s. They achieved parliamentary representation in 
1999 and after the 2007 election had 9 Members of Parliament, 4-5,000 members and c. 
50,000 contacts. The Party has 9 Provinces, over 50 branches, some of which are split across 
Provinces, and contest elections across all 67 electorates (which do not align with either 
Provinces or Branches). Prior to adopting CiviCRM the party and parliamentary units had a 
range of systems for managing members, donations, contacts, campaigning, media and 
advocacy. 

The Green Party policy states: 

• Development of IT must be socially responsible and sustainable. 

• The use of Free and Open-Source software should be encouraged. 

What They Did 

CiviCRM was adopted in 2007 (version 1.7). This was encouraged in part by the work that had 
been done developing a voter canvassing Drupal module by the Canadian Greens. A switch to 
Drupal was undertaken as a parallel project. A Party database was set up using CiviCRM and 
online donations, memberships and event registrations were instigated. 

The Greens have over 100 different issues that they put media releases out about. These 
were reconstructed as a checkbox custom data field, and Smart Groups were built for each of 
these, for use when sending out media releases via CiviMail. 

The highly complex 'access control' requirements of the party necessitated the development 
of an alternative approach to the use of ACLs in order to provide a more easily managed, 
highly granular system. This approach has now been incorporated as a hook (something that 
can be utilised by developers to extend CiviCRM) in to core code. 

For the election campaign in 2007, a look-up function was developed that meant as new 
contacts were added to the database, they were checked against a table containing the 
Electoral Roll, and links were created where matches were made. 'Soft' matches were also 
recorded. 

The Results 

In the 2007 election campaign, the Party made extensive use of online fundraising and greatly 
exceeded previous online income. The membership renewal has been streamlined with more 
online renewals occurring. 

As of May 2009 the Greens are still using 2.0 on Drupal 5 and therefore have not yet 
benefited from the many features that became available through the 2.1 and 2.2 releases. An 
upgrade is in progress. 

What They Learned 

In a complex organisation such as the Greens, training is often going to be a limiting factor, as 
well as the need to develop more in-house superusers. New features in CiviCRM have caused 
some rethinking about usage of custom data fields, particularly in terms of the use of CiviMail 
for media releases. The new options for both nested groups, and Drupal Organic Groups 
suggest that a more time effective approach may be possible. 

QUESTBRIDGE 



QuestBridge is dedicated to helping bright, motivated low-income high school students get 
accepted and pay for college. QuestBridge recruits high-school juniors nationwide and asks 
them to fill out the QuestBridge application online. QuestBridge also partners with America's 
most highly-selective colleges and universities that are looking to increase the socio-economic 
diversity of their student bodies. QuestBridge's college partners accept the QuestBridge 
application in lieu of their own admissions application. 




What They Did 

QuestBridge built most of its business processes around the CiviCRM. They wrote their online 
admission application using CiviCRM and extended it using PHP. They used CiviCRM to store 
biographical/application information and communication histories about the students. 

The Results 

In 2008-9, QuestBridge helped more than 1200 students get accepted and pay for college at 
one of its 25 partner schools. It accomplished its goal in a very efficient manner, in part due to 
its effective implementation of CiviCRM. QuestBridge is currently planning on upgrading to 
CiviCRM 2.x in order to take full advantage of the new email features. 

Learning 

If Questbridge were to start over they would have invested more in training on CiviCRM 
upfront. 

SCHOOLHOUSE SUPPLIES 

Schoolhouse Supplies (SHS) is a Portland, Oregon, USA based non-profit organization which 
gathers and distributes school supplies to students and teachers. 

Prior to CiviCRM SHS used a combination of software programs including Exceed, EROI, 
Constant Contact, Salesforce, Auction Pay (for online contributions) and, of course, hundreds 
of spreadsheets. In addition, SHS had a custom web application for managing store inventory 
and for processing in-kind donations. 



What They Did 

SHS has centralized their operations to CiviCRM to manage all their constituent data and to 
unify and coordinate several of their core business processes. 



All data from each source has been migrated to CiviCRM Standalone. CiviContact and 
CiviContribute have replaced Exceed and Auction Pay. CiviMail has replaced EROI and Constant 
Contact. Salesforce data was moved into CiviCRM and the custom ecommerce application it 
supported was integrated with CiviCRM. Lastly, the inventory/in-kind management system was 
integrated with CiviCRM. Spreadsheets have been imported. 

The Results 

Each business process at SHS now can take advantage of their full constituent database and it 
is easier to coordinate business activities. More importantly, SHS is now in the process of 
taking manual business processes (e.g. volunteer coordination) and moving them to CiviCRM. 
New campaigns are now being planned and executed which would have been impossible or 
prohibitively expensive before. 



5. 



WHAT IS CIVICRM? 



CiviCRM is a powerful web-based customer relationship management (CRM) system. It 
allows you to record and manage information about the various people and organizations that 
are important to your organization. CiviCRM is more than just an address book, it also allows 
you to track your interactions with people and organizations and to get them to engage with, 
and potentially give money to, your organization through your website. The information you 
gather is all stored in one place but you can access it from almost anywhere. 



AcivicRM^- 



CiviCRM is open source, which means there are no license costs or user fees associated with 
downloading, installing or using the software. You may incur costs if you use a consultant to 
implement CiviCRM to meet your specific needs and you may incur website hosting charges. 

CiviCRM is web-based, which means it can be accessed by many users at the same time 
from different locations. It has been developed with the international community in mind, and 
translations and multi-language options are supported. 

It has been designed specifically to meet the relationship management needs of advocacy, 
non-profit and non-governmental groups. It integrates easily with two of the most widely used 
free and open source content management systems (CMS), Drupal and Joomla!. There is also 
a standalone option for users who wish to have CiviCRM working alongside another CMS. 



CIVICRM CONCEPTS 

6. WHAT IS A CRM? 

7. WHAT IS A CMS? 

8. WHAT DOES WEB-BASED MEAN? 

9. WHO IS CIVICRM? 
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WHAT IS A CRM? 



Reading about CiviCRM, you might encounter quite a lot of different terms and concepts that 
are new or not fully clear to you. Some of them will be technical words or acronyms (for 
example, module or CMS) and some of them will relate to broad phenomena (such as Free 
Software or NGO), and the philosophy that underpins CiviCRM. Here we explain the most 
important definitions and notions, as well as some of the specific ideas that will add to your 
understanding of CiviCRM. Even if most -- or some -- of these concepts are clear for you, it 
might still be good to skim through this chapter to get on the same page with other people in 
CiviCRM world. If you are beginning your adventure with CiviCRM, this is definitely the place to 
get you into the groove and find explanations that will make further reading easier. 

WHAT IS CRM? 

There is a vast array of software from both the commercial and open source sectors that 
belongs to the CRM category. CRM is often understood to be customer relation 
management: software used to track engagement with current and potential customers from 
a sales perspective. CiviCRM is similar in concept but is built from the non-profit, not the sales, 
perspective. 

So what does a CRM do? One simple answer is that it is a contact database with many 
additional abilities. Imagine your address book - it's a pretty simple way to keep track of 
important contact information. Now imagine that every time you make a phone call to a given 
person, your address book automatically makes a note of it, together with brief description of 
the conversation and also schedules a follow-up meeting with the contact. After using this 
address book for a while, you could ask "what were my interactions with a given person?" and 
it would give you the whole history. 

Now let's say you're organising a dinner party and you want to invite all the people you've met 
during the previous year, with party invitations, of course. Just write the invitation and tell 
your address book to send the email. You don't have to worry about anything else after this 
point (apart from preparing the dinner!) Your address book handles the RSVPs from all invited 
guests, together with information about who is vegetarian and who is not and it even lets you 
know two nights before the event how many people you can expect. 

It would be great to have such an "assistant", right? Both in your personal life and at your 
organisation. A large part of non-profits' work is about different interactions with people and 
organisations; talking to them, doing things together. While in your personal life it's hard to 
remember all of your meetings, phone calls and other forms of contact (especially in very long 
term) it's also not crucial to stay on top of all these interactions. With organisations it's 
completely the opposite - the more you know about the people and organizations you interact 
with, the more successful your work will be. You'll be able to target your message to specific 
groups, because you know who will be interested in specific topics, and you'll be able to 
observe their reactions and adjust your next interaction, and continue to improve how you 
talk to different groups. 

Just to give you an example of the wide variety of constituents that are you might need to 
address, let's try to answer the question: "Who does your organization interact with?" A quick 
and undoubtedly incomplete list would involve: 



• Donors and Funders, 

• Organization Members, Advisory Groups, Board Members, 

• Volunteers, 

• Supporters, 

• Legislators, 

• Partner organizations, 

• Grantees, 

• Media, 

• Your Organization's Beneficiaries, 

• Suppliers, Contractors, Consultants, 

• Website Visitors, 

• Event Attendees, 

• Petition Signers, 

• Trainees/Alumni, 

• ...and more! 

At any one time, your organisation will interact with at least a few of these different groups: 
you'll want to engage with donors in a different way to volunteers, you'll need to exchange 
information with grantees in a completely different way than event attendees. Over time, the 
amount and variety of information becomes overwhelming. 

That's where a CRM comes to the rescue. It will not only allow you to automate different 
tasks but it will also enable your organization to accumulate the knowledge about different 
groups of contacts, and communicate with each group in a way most suitable to them. 

"CONSTITUENT"? 

CiviCRM, unlike most CRMs, is oriented specifically toward the needs of non-profits, advocacy 
and non-governmental organizations (NGOs). It is for this reason that CiviCRM avoids using the 
word "Customer", and uses "Constituent" as it better illustrates the interdependent 
relationships of advocacy and non-profit organizations. Other terms such as "client" and 
"contact" are also used for the 'C of 'CRM'. Whatever the 'C stands for, the main principle of 
a CRM stays the same - it helps your group or organization track and organize contacts. 
However CiviCRMs functionality has been designed to support the needs of fund-raising or 
event organizing activities rather than the process of sales of individual items, although the 
latter is also supported. 

WHAT IS A DATABASE? 

"CiviCRM is a contact database" - and what is a database? Let's take a look at a quick 
definition, in case you are not fully familiar with the concept. 

There is a certain discrepancy between how computer science treats the definition of a 
database and how is it used in common communications. Formally, a database is a collection 
of data, ordered in a specific way. To take a look at an example: your little notepad with 
phone numbers (or your mobile phone's address book) contains a database of phone numbers, 
your local library's card catalogue contains a database of information about books. Using 
formal language again, the tool that is used to manage the data is called a Database 
Management System (DBMS) - so in our examples, the notepad itself, the mobile phone or the 
cabinet that holds the index cards are DBMSs. However, in common use, the term database 
refers to both the collection of data and the tool that is used to manage this data. So, let's 
not bother too much with formal definitions in the context of thinking what a CRM is - you can 
use the above formal definitions to have fascinating discussions with your geek friends over a 
glass of wine. For the sake of this text, we will be treating the definition of database as a 
combination of a tool and the data stored in it. 

Since we are talking about CRMs (CiviCRM particularly), let's explain the database concept using 
a collection of contact data. A database is made of records - each record represents one 
contact. A record is made of fields describing, let's say, a person: first name, last name, email 
address, phone number and so on. Records can be related to other records - for example, a 
contact record can have a related event participation record. 



So when we talk about databases we are referring to a powerful tool that can store and 
combine data in interesting ways. CiviCRM is powerful because it leverages these basic 
features of a database in very smart and useful ways. 

WHAT IS A MODULE? 

There is one more concept of CiviCRM that deserves a very simple explanation - the module 
or component. In the context of CiviCRM, and considering the scope of this text, a module is 
basically a group of functions related to one aspect of organization's work. For example, all of 
CiviCRM functions that help you manage events have been gathered together in one module 
called CiviEvent. 

CiviCRM modules, also referred to as CiviCRM components, can be enabled and disabled as 
needed. If your organization's activities do not include organizing workshops, conferences or 
other meetings, you can just disable CiviEvent module to avoid unnecessary complication of 
the tool - and help keep the interface uncluttered. Once you decide that you want to manage 
these kinds of activities, the module can be enabled and the functionality will be immediately 
available for use. The term module also appears in the context of Content Management 
Systems. The meaning is the same as in CiviCRM - basically modules allow you to extend the 
functionality of a given CMS or CRM. 

FURTHER READING 

Customer Relationship Management on Wikipedia 

http://en.wikipedia.org/wiki/Customer_relationship_management 

Database on Wikipedia 

http://en.wikipedia.org/wiki/Database 
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WHAT IS A CMS? 



CiviCRM has been developed so that it is tightly integrated with two popular Content 
Management Systems (CMS): Drupal and Joomla. It is also available in a standalone version. 
This means it can be operated alongside any other type of CMS although more complex 
implementation required to set it up correctly. First though, let us take a step back and get an 
understanding of what a CMS is and how it having CiviCRM cooperating with them helps us. 

WHAT IS A CONTENT MANAGEMENT SYSTEM? 

In simple words, a Content Management System is a tool for building and managing a website. 
There are other broader definitions expanding the meaning of content to all kinds of digital 
information but in the context of CiviCRM's connection with CMSs we'll stay with the simple 
definition. 
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Drupal Content Management System - Content Types Screen 

Generally a good website should be laid out in a clear and ordered way, visitors should be able 
to navigate in between different pages easily, information published should be kept up-to-date. 
Making sure that all these requirements are met usually takes quite a lot of work. The role of 
CMS is to make such work easier, quicker and more effortless. A website administrator using 
a good CMS tool should be able to spend as little time as possible on technical tasks and as 
much time as possible on creating and publishing actual information. 

A good Content Management System: 

• simplifies the initial building of your website 

• allows your organization's staff and/or volunteers to update the content on the website 
easily 

• allows your website visitors to interact with your organization 

If your organization doesn't have a Content Management System yet now is a good time to do 
some research into adopting one. Choose wisely and make sure it meets the criteria listed 
above. 
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Joomla! Content Management System - Control Panel screen 

Websites were originally meant to be places to publish information for visitors to read. This 
paradigm changed a long time ago and organizational web pages are now two-way 
communication channels. You can use them both to communicate your message, to gather 
information about the people who support you, to enlist people to help you and hopefully to 
donate money to you. A good CMS makes this process even easier. 

HOW DOES CIVICRM WORK WITH CMS? 

Traditionally, you don't get to know a lot about the people that visit your website. The most 
commonly gathered information about a website is the number of visitors and the number of 
page displays. This data gives you an idea about how popular your website is but doesn't give 
you any idea about specific individuals visiting the website. 

This is where CiviCRM really comes into its own. It not only gives you tools to quickly extend 
your organization's page with interactive elements, it also stores information about the specific 
actions taken by your website visitors. Moreover, for each person who engages with your 
activities through your website you will be able to see a history of your interactions with 
them. If somebody signed your petition first, then signed up for an online newsletter, then 
donated a couple of times to support different campaigns and finally became a member, you 
can see what they did and when. Interesting? Not only interesting - seeing the detailed history 
of the most engaged supporters of your organization might give you some very solid ideas on 
how to run your online activities in order to get the best effects. 

That's the high level view on CiviCRM - CMS integration. What does it look like from technical 
point of view? CiviCRM basically works as a module to a CMS (Drupal or Joomla!). The obvious 
advantage is that you can quite easily extend your website with all the functions offered by 
CiviCRM and start gathering information about your constituents. Many other possibilities are 
open to you when you think about how you can take advantage of the other modules that 
work within both Joomla! and Drupal. 

FURTHER READING 



Content Management System at Wikipedia 

http://en.wikipedia.org/wiki/Content_management_system 
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WHAT DOES WEB-BASED MEAN? 



CiviCRM is a web application. This essentially means that people who use CiviCRM access it 
using a web browser (such as Firefox, Opera, Safari, or Internet Explorer). It also means that 
you can set it up so that it can be accessed over the internet. You need to install CiviCRM on 
a server, a computer that delivers (serves) web pages. If you want it to be available over the 
internet the server needs to be accessible from the internet. 

Some organizations are large enough manage their own servers and have people trained to 
administer them; others use hosting services. Clearly if you are planning on using a hosting 
service, you must ensure that they can fully meet the requirements for hosting CiviCRM. 

ADVANTAGES AND DISADVANTAGES 

With web-based software you only need to install it on one server. You don't need to make 
changes to desktop computers or laptops throughout your organization. Therefore, the cost of 
using web based applications is usually lower than for software that has to to be installed 
directly on end-user computers. There is a 'real' cost connected to maintaining the software 
on the server - you do need to spend time administering the server or pay for hosting. 
Fortunately that cost is usually much less than servicing many computers throughout your 
organisation. This benefit is particularly obvious when introducing a new version of the 
software - an upgrade on a web-based software only needs to be done in a single place and it 
is immediately available to all users. 

Another related advantage is that your staff and volunteers can use the software from 
practically any computer. You can sit volunteers down at temporary workstations to do data 
entry, or ask them to bring their laptops, with no need for special preparations: CiviCRM will be 
instantly available from any computer in the office. This is also very useful for people in your 
organisation that work remotely: they can use CiviCRM from wherever they are located, as 
long as they have an internet connection. 

The next advantage might seem obvious, but it's still worth mentioning. Many people can be 
working in CiviCRM at the same time. So while one person is picking up the phone and 
registering information about a constituent in CiviCRM, someone else might be changing 
information about another constituent or generating a report. 

Another advantage of web-based applications like CiviCRM is that your data is centralised. 
Your data is precious and should be protected from loss, which means you want to make 
backup copies of the data as frequently as possible. When data is distributed among many 
computers, this becomes complicated and solutions that provide effective backup tools in such 
circumstances are usually quite expensive. Having your data in one place allows you to protect 
this key asset easily. 

There are obviously some limitations to using web based applications. The main one is network 
dependency: your staff and volunteers need to be able to connect to your server in order to 
use CiviCRM. If your CiviCRM website is on the internet and they don't have internet access or 
it's on your intranet and they can't get to it then web-based applications are probably not the 
best choice for you. 

FURTHER READING 

Web based applications 

http://en.wikipedia.org/wiki/Web_application 
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WHO IS CIVICRM? 



CiviCRM has a unique and diverse and community centered around developing, using, and 
documenting the software. Our community includes the CiviCRM core team, people at the non- 
profits that use CiviCRM; consultants working with a number of non-profit organisations; 
programmers and developers, power users, volunteers and community organisers! We are also 
closely related to many other open source projects. 

Each member of the community interacts with CiviCRM in their own way, working to improve 
the software and how we organise ourselves. The strength of community comes from this 
diversity and the ease with which someone can join us, and means that we are constantly 
changing and improving, often in unexpected ways. 

Like all communities your membership is characterised by your interactions. If you treat 
others well, have some fun, and help others, then you can expect to enjoy being a member of 
the CiviCRM community. But if you are prone to complaining or don't use a respectful tone in 
communications, or if you see the community just as a resource and not as a collection of 
very kind, generous and clever people, then you are probably not going to get much of a 
response. Treat people well and you can find the CiviCRM community fun and rewarding. 

IT'S GOOD TO TALK 

CiviCRM is an open and learning community, and people are ready to hear your ideas. If you 
have a good idea, there's nothing to stop you carrying it out - but the best way to start, is to 
start talking about it. 

If you're not sure where to start, the best place is probably the community forum 
(http://forum.civicrm.org/) . Ask people what they think about your idea. There's a wealth of 
experience on the forum, and with a bit of luck, someone will have tried something similar 
before. CiviCRM people are a friendly bunch and their guiding philosophy is collaboration. 

Depending on your idea, you'll be directed to the next best place - maybe an article on the 
blog, a page on the wiki, a teleconference or a meeting up with another community member 
in real life, yes that's right, REAL LIFE! 

BE THE CHANGE 

So you have a great idea. Now you need an equally great action plan to accompany this idea 
and then you'll need implement it. Although the CiviCRM community is friendly and supportive 
and will like to be involved and updated about your project, you'll need to be the driver. How 
will you get the resources together for your project? How can you fit it in with your day job? 
Finding a way to simultaneously achieve your own objectives and benefiting the CiviCRM 
community is the best way of getting things done. 

AND FINALLY... 

If you're a CiviCRM user who has an ongoing relationship with a consultant, there's nothing to 
stop you from also being an active member of the community. The community really benefits 
from direct feedback from end users - your consultant is only one person or organisation - by 
asking on the forums you're opening yourself up to help and input from the entire community. 



IS CIVICRM FOR YOU? 

10. EVALUATING YOUR NEEDS 

11. EVALUATING CIVICRM 

12. ADDITIONAL CONSIDERATIONS 
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EVALUATING YOUR NEEDS 



Life is a series of making decisions. Some decisions are easy because they do not require a 
substantial investment of time or money. More importantly, easy decisions do not require one 
to do homework in order to make sure the decision is the correct one. Deciding which flavor 
ice cream to buy fits into this category: You really don't have to spend any time or do any 
homework around which flavor to pick. If you get vanilla today you can always get chocolate 
tomorrow. 

Other decisions are much more difficult not only because they may require substantial 
investments of money and time, but because you may have to live with your choice for the 
foreseeable future. Decisions like these often require a lot of planning and evaluation because 
once they are made, they are not easily undone and may continue to affect your life 
adversely on a daily basis. Buying a house fits into this category and, on some level, so does 
adopting a new CRM system. 

PLANNING PHASE AND PROJECT PLAN 

Regardless of whether yours is a large or small organisation or a one person "shop", and 
regardless of whether your requirements are complex or very simple, it is still important for 
you to do some level of planning and thinking about your goals. Obviously, the more complex 
your needs, the more time you will need to spend in the planning phase of your project, but 
statements like "I want a database to put my constituents into" or "I want to send a 
newsletter" often indicate that too little forward thinking has been done with regard to current 
organisational goals or how a new CRM system might be used to enhance constituent 
outreach. This is often a huge mistake; constituents are the life blood of any organisation and 
a CRM system is the most important tool available to help sustain that life and keep the blood 
pumping. 

In the planning phase, it is very important not only to think about your needs and goals but to 
document your thoughts by creating a project plan that may then be used as a reference to 
help you implement the decisions that you made. A well organised project plan will list, in a 
logical order, the various tasks that need to be completed and it will help you to develop a 
realistic time line for implementation. 

Whether simple or more complicated, a project plan can be invaluable as a resource for a 
successful implementation. It will be a work in progress that will be revised many times, so 
best to create it electronically if possible. 

Not all of the topics in this chapter might pertain to you. If your organisation is small or your 
requirements are very basic, the planning phase will not be as involved for you. A more 
complex and involved planning process, such as the one documented below, may be applied as 
a whole to larger organisations or organisations, regardless of size, with more complex needs. 
However, even if you see your CiviCRM deployment as small, it's still worthwhile to go through 
all the planning aspects described below and check if some of them apply to your situation. 

In general, but particularly for medium and large scale organisations, the relative success or 
failure of your CiviCRM implementation will be directly influenced by the amount of time that 
you spend, prior to installation, thinking about how to use your CRM system to embrace and 
enhance the relationship between your organisation and its constituents: the more time you 
spend on the "big picture", the more successful your CRM system will be in the long run. 

PREPARING YOUR PROJECT TEAM 

Unless you are a one-person shop, a critical part of your project will be picking the right people 
for your project team before the project begins. In fact, this should happen well before you 
finalize what your technology and database needs are. Once you establish who will be involved 
you then need to figure out what each person will be responsible for and what they will 
contribute towards the success of the project. 



Whom to Consider 

The team should include people from all aspects of your organization. If you are a large 
organization, this may mean staff from different departments or roles within the organization 
such as event coordinators, communications and marketing staff or fundraisers. If you are a 
small organization, one person invariably will have multiple roles so it's OK if they represent 
those roles within the team. The key here is that the team should represent the organization 
so that as the project progresses all interests and needs across the organization are taken 
into account. 

There is an understandable tendency to bring in "accidental techies" (someone with no core 
expertise in this area but who has somehow inherited the job of implementing the CRM 
system that is chosen) onto your team. It may seem counter-intuitive, but accidental techies 
sometimes are the wrong people to be involved in a technology project. This is because they 
may be too knowledgeable about some technical aspects of the project and will focus their 
time on how things should be done instead of what should be done. This is often unavoidable 
in smaller organizations but it is something to try and be careful of. 

When putting together your team, keep in mind that it might be a major time commitment - 
and a long term one. Throughout the project, the team should be meeting on a consistent 
basis (weekly or bi-weekly for large and complex projects). If a team member is not able to 
make that type of time commitment for the length of the project, then they should not be 
involved. 

Avoid bringing new people in half-way through the project. The team should stay together for 
the length of the project. Bringing new people in half-way through the project can require a 
major effort to bring them up to speed. 

Before you decide on how decisions will be made throughout the project you need to assign a 
team representative or point person. This person will represent the team to the person or 
people implementing the CRM system that you choose. Again, for smaller organizations, the 
team point person and builder may be one and the same! The important thing to remember 
here is that your point person must have a deep knowledge of how your organization works 
and what your needs are so s/he can articulate those things to the person(s) implementing 
your CRM system. This person should be heavily involved in the development of the project 
plan. S/he can then use that plan as a means of evaluating CRM systems. 

Ongoing support 

It's never too early to start thinking about maintenance and support. After the software is 
successfully deployed, somebody will have to install new versions, provide help and training to 
new employees who will be using the system and be able to react to any potential problems. 
It's usually good practice to have this person involved in the process from the very beginning. 

GENERAL GUIDELINES FOR PLANNING 

A couple of precepts will help you keep your decision-making process on track. Each member 
of the team should not only understand these precepts intellectually, but try to bring them 
into the heart of the discussions. 

The importance of creating a constituent-centric organization 

Your constituents, and the relationship that you have with them, are the most important 
assets in your organisation. If you believe this, then you realise how important it is to 
consciously and conscientiously ensure that your organisational processes and goals revolve 
around satisfying them. My guess is that the reason you are reading this book is because you 
are searching for new ways to improve and enhance the relationship between your 
organisation and its constituents. 

A well designed CRM system will make it easier for you to communicate more effectively with 
your constituents and to provide prompt and professional "personal" attention when 



necessary. There are many things you need to think through prior to installation and actually 
sitting down to use your CRM system. The steps below will direct your or your team's 
attention towards some of these things and will help you to formulate a solid plan on how best 
to create a constituent-centric organisation that uses its CRM system in an effective way. 

As you read through the topics below, keep the relationship with your constituents at the 
center of your focus and think about what your organisation needs from a CRM system to 
enable it to communicate more effectively. 

Look at organisational processes first and follow with technology 

For now, forget about technology! That's right, forget about technology and forget about 
CiviCRM. The reason I say that is because there are likely several CRM systems that would 
meet your needs, but if you aren't clear or aware of what those needs are, even the best 
CRM system will fall short of satisfying you: you will blame this on the system, but the fault 
lies with you for not having done your homework before class :) So forget technology for now 
and and focus on thinking about the organisational processes that you employ to communicate 
with your constituents. Work to re-mold these processes so that they reflect the goals of 
your organisation. 

DECISION MAKING PROCESS 

Now that the team is assembled with a representative, the decision making process should be 
finalized. In the non-profit sector there is a strong ethic and value placed on making decisions 
by consensus. In general, this is not a bad thing but when applied to technology projects, it can 
sometimes significantly slow a project down if every decision must be agreed upon by the 
entire team before moving forward. It is recommended that you instead maximize 
collaboration and discussion throughout the project and decide on how to handle decisions 
when things come to a disagreement. In many cases a simple vote can work. In extreme 
cases, it may involve bringing the issue to leadership within your organisation and having them 
make the final decision. 

Take advantage of institutional knowledge 

Talk to your co-workers, particularly those who have been around the longest, and use their 
"institutional memory" to record the kinds of interactions they have had with constituents. 
Cast a wide net here: make sure to talk to people who handle each key point of contact with 
your constituents, and learn about the experiences with all kinds of constituents. Use this 
information as a guide to define processes that will build organisational value. 

Define the desired set of constituent experiences 

How does your organisation want to relate its constituents? This will vary on a case by case 
basis, but here are some suggestions for the sorts of things you might think about: 

• Giving constituents the ability to select which mailings they want, how often they want 
to receive them and, the ability to unsubscribe/opt-out of your mailings 

• Honoring constituent requests. Some examples: 

o if a constituent indicates that they do not wish to receive an acknowledgement, 

don't send one! 
o if a constituent sends an address change, make sure you update your records 
o if a constituent indicates that they only want to receive one solicitation, don't 

bombard them with requests 

• Prompt acknowledgement of contributions and/or correspondence 

• No duplicate mailings 

• Maintaining accurate information about constituents (name, address, interests etc) 

• Event registration 



After you have determined how you want your organisation to relate to its constituents, 
examine your organisational processes and change or eliminate those that are not conducive 
to providing your constituents with the type of experience that you want them to have. The 
next section will help you think through that process. 

Examine organisational goals and practices 

Think carefully about your current organisational processes and how they may be falling short 
or impeding your ability to communicate effectively with your constituents, and create a plan 
for what you need to do to remedy that. 

Here are some areas you might think about: 

• What are the goals of your organisation? 

• What are the core processes in your organisation? 

o What happens in your organisation when you receive someones contact data? 
o How does your organisation handle mailings to households and individuals in those 

households? 
o How do you respond to snail/email correspondence from your constituents? 
o How do you communicate the financial standing of your organisation? 
o How easy is it to get data out of your current system(s)? 

• Do you have a way of knowing when a constituent is losing interest in your organisation 
and why? 

• Is it straightforward and easy for your constituents to report problems that they have 
with your organisation? 

• How easy is it for your constituents to learn about and sign up for upcoming events, 
meetings, campaigns etc 

What functions must your new CRM system address? 

With a good idea of what you want to offer your constituents, and your staff, ask how 
CiviCRM's features can help your organization. Some common needs follow. 

o Fund raising, online and offline (such as through email)? 
o Communications? 

■ Snail mail? 

■ Email blasts? 

■ Newsletters? 
o Memberships? 

o Managing specific relationship types? 

o Events management? 

o On-line registration? 

o Specific reporting needs? 

o Sorting and grouping 

o Sharing data with other systems? 

o Volunteer tracking? 

TECHNICAL AND LOGISTICAL PLANNING 

Technology, money, time, and expertise in your organisation all play a role in getting CiviCRM 
up and running. 

Establish a budget for your project 

It may be that you or someone in your organisation can handle the entire implementation. If 
that is the case, your costs will be more in the area of time rather then money. If that is not 
the case, you should probably figure out how much money you have to spend on this project. 

Possible costs are : 



• Purchasing a server to host your CRM system 

• Hiring a consultant to help you with some or all of the planning and implementation 

• External Hosting: you pay a monthly hosting fee to a vendor and, depending on what 
services you request, they maintain the server and backup your data (for example) 

• On-going paid support for problems that may arise after implementation 

• Customisations to the software (if the out-of-the-box product does not meet your 
needs) 

Identify repositories of data 

Because you can't do much with CiviCRM until you get your existing data into it, plan how you'll 
do this considerably before you set up CiviCRM for production use. 

• Identify all existing sources of data that you plan on importing into the new system 

• If the data is currently stored in "proprietary" software, are you able to export it? 

• What kind of shape is the data in? Does it need substantial cleanup and de-duplicating? If 
so, who will do this work? 

Identify the operating system and browser that will be used by office staff 

Some CRM systems might not be compatible with the operating system (GNU/Linux, Mac OS X, 
Windows, etc.) and Web browser (Chrome, Firefox, Internet Explorer, Opera, Safari, etc.) that 
your staff are using. To avoid choosing a system that will not work properly, take an 
inventory of computers and make a list of the browser software being used. 

Identify the information that you wish to collect and track 

Your decision-making process describes in general your organisation's information needs, but 
now you want to determine exactly what fields you'll need in CiviCRM. 

• Make a list of each field that you are currently tracking 

• Add to the above list, any new information that you wish to track 

• Anything else? 

o Interests 

o Groups 

o Donations 

o Volunteers 

Identify the staff who will use the system 

You may need to free some of your staff from existing duties to handle CiviCRM, although the 
system should save you time and effort after it's deployed. You may also need to hire a staff 
person with technical skills, or bring in a consultant. 

• Make a list of staff who will be using the system 

• For each staff person, figure out what kind of data they need to access and decide what 
kind of access they need. For example: A volunteer probably needs to be able to see 
("read" access) and update ("write" access) constituent name and address data but you 
might not want them to have any access to contribution data. 

• One way to approach this is to create a variety of "roles". Each role is associated with 
certain permissions. After you have established the roles and respective permissions, 
assign individual users to specific roles. Examples of roles are: volunteer, fundraiser, 
administrator, event coordinator, membership coordinator and data entry. 

• Identify the administrative "owner" of the system: a point person who will be responsible 
for handling the technical aspects of managing and maintaining this system. Determine 
the technical skill level of this person. Do they have the skills that are necessary to 
successful implement the system? 

Identify support needs 

Some questions to ask yourself include: 



• Once the system is in place, how will it be supported? 

• Who will be in charge of updating and inputting data? 

• Who will support it, answer questions etc 

• Is there sufficient in-house technical expertise to support both the system and the 
people who use it? 

• Is any support available from the providers of the CRM system? 

o Is there a cost for this support? 
o How easy is it to get support? 

Establish a training plan 

Establish a training curriculum and a timeline for training users. The curriculum should 
encompass all the various functionality that your organisation requires. It should provide 
function-specific training for those in certain "roles", and general, overview-type training for 
more "casual" users. While everyone would probably benefit from an initial overview of the 
new system, not everyone needs to sit through a two hour training session on how to manage 
events (for example): Only the person responsible for event management and planning would 
need that training. 

Some examples of what you might include in your curriculum are: 

• Overview of the features of the new CRM system 

• Explanation of available record-types (individuals, households, organisations, etc.) 

• Data entry: how to view, change, add and delete records 

• How to assign your contacts to certain groups 

• How to perform searches: simple and more complicated 

• Import and Export 

• Searching for duplicate contact data and eliminating duplicate records 

• System administration 

• Permissions 

• Custom Data 

• Relationships 

• Mailings 

• Contributions 

• Events 

• Other: your curriculum will vary depending on the features that your CRM system has 
and on the needs of your organisation 

Training should be as close to final implementation as possible so that people can begin using 
the system while training lessons are still fresh in their minds. 

FINAL THOUGHTS ON EVALUATING YOUR NEEDS 

Hopefully, the information in this chapter was helpful in prompting you to think about the 
larger, more important picture. While the things listed here might be helpful, please realise 
that each organisation is unique. For some, the topics here may be overkill but, for others, 
there may be many things that were not mentioned. It should also be clear by now that the 
your larger your organisation and the more complex your needs, the more planning is required 
for a successful CRM system before it is actually implemented. 

For those with complex needs: If you have read and thought about the topics in this chapter 
and you feel confused or "intimidated", it might be time for you to consider hiring a professional 
to help you with this important phase of your project. 
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EVALUATING CIVICRM 



Much of the information in this chapter assumes that you have already evaluated what your 
organization needs from a CRM system. If you have not done that, you might want to before 
reading this chapter. 

CiviCRM is a complex and powerful software. It is critical that before deciding to use CiviCRM, 
you evaluate whether or not it is right for your organization and will fundamentally fit its 
needs. Broadly speaking, there are four approaches to evaluating whether CiviCRM is right for 
your organization: 

• Play with the free demonstration site, 

• Talk to other users and organizations using the system, 

• Install a test database, 

• Hire a CiviCRM consultant. 

As you try any or all of the above methods, it is critically important to always remember your 
needs as an organization. Resist the temptation to be drawn to things that are "cool" but may 
not ultimately benefit your organization's mission. 

DEMONSTRATION SITES 

CiviCRM hosts three freely accessible demo sites - one for each of the two supported 
Content Management Systems, Drupal and Joomla!, and one for standalone mode. The 
demo sites all present a working copy of the latest stable version of CiviCRM with sample 
data. You can play with CiviCRM on these sites as you wish but be aware that they are 
publicly viewable so don't enter any real data. 

• Joomla! Demo: http://ioomla.demo.civicrm.org/ 

• Drupal Demo: http://drupal.demo.civicrm.org/ 

• Standalone Demo: http://standalone.demo.civicrm.org/ 

There are a few limitations of the demo sites. They do not send out emails, you do not have 
access to creating permissions for users, and you can only do limited exploration of accepting 
online payments. 

TALK TO OTHERS 

If you know an organization using CiviCRM, then talk to them about their experiences. It would 
be most helpful to talk to someone who has had experience in an organisation which is a 
similar size and has similar operations to your own organization. If you don't immediately know 
anyone who has used CiviCRM, then visit the CiviCRM forums. 

The forums, hosted online at CiviCRM.org, are an excellent resource for just about anything 
you can think of that is related to CiviCRM. The forums are there to help people like you get 
answers to your questions about CiviCRM so that you can decide whether or not it is right for 
your organization before investing too much time or money. You can explore the CiviCRM 
forum site here: http://forum.civicrm.org/ and you can start asking your questions whenever 
you are ready. 

If you are brand new to CiviCRM, the topics that are probably of most interest to you at this 
point are the discussions under the forum board called "Pre-installation Questions" 
(http://forum.civicrm.org/index.php/board, 5.0. html) . 

If you wish you to contribute to the discussions or ask questions you must register first 
(http://forum.civicrm.org/index.php?action= register) 

Also worth checking out is the "documentation" section of the forum. This section does not 
give any detailed instruction on how to use CiviCRM, but will give you a general overview of its 
capabilities. 



TEST INSTALLATION 

Another option for those with more technical skills is to download CiviCRM and set it up on 
your desktop or server. Be advised that doing this requires some advanced technical skills, so 
is probably not a useful option if you don't have those and don't have anyone who can help 
you. 

if you want to pursue this option, up-to-date information for installations (including 
troubleshooting tips) is maintained at 

http://wiki.civicrm.org/confluence/display/CRMDOC/lnstallation+and+Upgrades . You should 
always refer to that information when installing or upgrading a test or real installation of 
CiviCRM. 

HIRING A CIVICRM CONSULTANT 

If you have complex needs, regardless of your size, you may want to hire a CiviCRM expert to 
help you through the process of evaluating CiviCRM. On CiviCRM.org there is a page that lists 
professional vendors and consultants that can help walk you through CiviCRM. This may 
include providing a more detailed hands-on demo of the software and answering some of your 
specific questions. To see the professional services page on CiviCRM.org visit: 
http://civicrm.org/professional 
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ADDITIONAL CONSIDERATIONS 



In addition to ensuring that CiviCRM provides the features that you need and that it is easy to 
use, you need to consider and plan for several other important things prior to choosing 
CiviCRM: 

• Whether you will use a Content Management System (CMS) and, if you will, which one 

• Where your CiviCRM site will be hosted (where will you obtain the internet services you 
require) and whether you will host it yourself or pay someone else to do that 

• The amount of resources you will need to make the CiviCRM implementation a 
successful one 

All these criteria require complex considerations unto themselves. This chapter is just a brief 
guide to introduce you to things you'll need to consider before installing CiviCRM. 

DO YOU NEED A CMS? 

One of the biggest criteria for determining if CiviCRM will meet your organizations needs is to 
consider your needs when it comes to website integration. In other words, if a substantial part 
of your needs require a system that accepts online donations, online event registrations and 
member logins, then a critical element of your implementation will be integrating CiviCRM with 
one of the two Content Management Systems that it works with: Joomla and Drupal. On the 
other hand, if your organization has no need for on-line functionality, you might be better off 
with the standalone version of CiviCRM. The choice is up to you, but do be sure to consider 
carefully. 

What are Drupal and Joomla? 

Drupal and Joomla are open source Content Management Systems; complete environments 
for creating, organizing, and granting access to website content. They provide an easy way to 
create and edit your website content and can be extended with a number of features such as 
forums, photo galleries, blogs, and much more. 

Integration with CiviCRM means that you effectively end up with a complete and very powerful 
system that can handle all of your external communication and outreach (website, email, etc.) 
as well as all of your internal data management needs (such as donors, members and 
events). 

The downside to using a CMS in addition to CiviCRM is that you will need to maintain and 
upgrade both systems. 

Standalone vs CMS 

If you are not interested in or ready to consider using a CMS then you might choose to use 
CiviCRM's Standalone mode. The trade-off here is that you won't be able to take advantage of 
all the CMS's great integrated online features. Alternatively you might install CiviCRM as part 
of a CMS but not explore the CMS's features until later. 

Some examples of organizations using CiviCRM in standalone mode include those that: 

• have a CMS other than Drupal and Joomla. These organizations have to create a very 
customized system that integrates with CiviCRM. 

• just need CiviCRM for one specific thing like basic contact or event management and 
don't need website integration. 

• don't intend to use a CMS but want to start using CiviCRM anyway. 

Drupal or Joomla? 



Both Drupal andjoomla have large communities of users who are passionate about them. It is 
generally accepted that Joomla is easier to get started with and more user-friendly, whereas 
Drupal offers a greater range of possibilities but has a steeper learning curve. Software 
developers often favor Drupal, as it is easier for them to extend. 

An important factor to consider when choosing which type of CMS to use is how important it 
is to you to control access to certain information or features. Joomla simply divides people into 
users who can access its administrative functions (including CiviCRM) and those who can't. With 
Drupal, you can create a much more detailed permission system by determining which roles in 
your organization (such as volunteers, executive directors or interns) can access or use which 
parts of CiviCRM (or Drupal for that matter). For example, with Drupal, an organization can 
limit access to their list of major donors to only the executive director and the development 
director. You can also allow some people to edit CiviCRM data but others to only view it, or let 
some people see membership record details, while others only have access to the contact 
details. 

More information about Drupal is available at their web site: http://drupal.org/node/152218 

More information about Joomla is available at their web site: http://www.joomla.org/about- 
ioomla.html 

HOSTING 

Before you install CiviCRM you should give some thought as to how you will acquire the 
Internet services (sometimes referred to as hosting services) you require and who will 
perform the technical tasks required to maintain the environment. There are several things to 
consider here: 

• Maintaining the server on which CiviCRM and the CMS (if you use one) is stored 

• Keeping the software required by the server and CiviCRM (commonly Linux, Apache, 
MySQL, PHP, etc.) up-to-date 

• Having someone available to fix problems that inevitably occur from time to time and 
could take down the server. If you want your site to be 24/7 (24 hours a day, 7 days a 
week) then your support needs to cover this. 

• Daily backups of the CiviCRM and CMS (if you use one) databases 

• Sufficient administration access to the server by you or by someone who is helping you 

• Monthly costs if you decide to have someone else host your site. 

These things do require some advanced knowledge of servers and hosting environments, so 
this may be a good topic to discuss with a technical consultant. 

If you do decide to have your site hosted externally (by someone else), you should keep in 
mind that unfortunately, in the hosting provider world, you get what you pay for. In many 
cases, cheap hosting providers keep their prices down by limiting the services or flexibility they 
provide. Other, more expensive options may be much more reliable, flexible, and stable. If you 
would like to see some "reviews" of hosting providers, look at 
http://wiki.civicrm.org/confluence/display/CRM/Hosting+provider+information. 

Before teaming up with a hosting provider, you should make a list of your requirements and 
make sure that the vendor you are considering can and will provide them. It's best to get 
them to confirm they can meet your needs in writing before making a commitment. 

If you decide to host the site yourself, there are two possibilities: if you have someone on 
staff who is technically able to manage the site, that's great! If you don't, you might consider 
hosting the site internally, but hiring someone who can manage it remotely. These days, there 
are very few things that can not be done via remote access, so this might be a good 
compromise if you want to save money by avoiding the monthly hosting fee. Just be sure to 
carefully interview anyone you are considering. 

OTHER RESOURCES 



All successful technology projects require investments of time and resources, and CiviCRM is 
no different. The last, but certainly not least, thing to consider when evaluating whether 
CiviCRM is right for you is to assess how much of your organizational resources (time and 
money) you can devote to making CiviCRM truly work for your organization. For larger 
organizations with complex needs, a successful CiviCRM project can take several months of 
planning, development, and training to be successful. This reality is important to keep in mind 
as you evaluate CiviCRM, or any database system for that matter. 

Several tasks that will require someone's time and expertise include: 

• Installing CiviCRM and the CMS (if you decide to use one) 

• Applying updates, which are released frequently by the development team, to CiviCRM 

• Applying updates to the CMS system (if you decide to use one) 

• Backing up CiviCRM and the CMS databases (unless they are being hosted externally) 

Be sure that you have lined up the appropriate resources, both money and staffing, before 
making a decision to adopt CiviCRM. 
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ONE STEP AT A TIME 



CiviCRM can be used for the majority of your non-profit's information and communication 
needs. You'll probably want to use it for as many of these needs as possible but you should 
resist the temptation to switch everything to CiviCRM from day one. Some CiviCRM 
implementations are simple, and some are more involved, but whatever your level of 
complexity you may benefit from an incremental approach. 

WHY IS IT SENSIBLE TO BREAK THINGS UP? 

Non-profit staff usually wear many hats and are busy with day-to-day work. They may view 
the CRM as unimportant or incidental to what they do. Implementing a CRM often requires 
significant changes in working practices for staff. A useful approach is to break 
implementations up into discrete stages. This allows staff to get used to the changes gradually 
and makes the adjustment easier to manage. 

Introducing functionality a bit at a time also gives breathing room to the implementer, making 
it easier to change or undo things should that become necessary. Any mistakes you make 
won't be "global" and you'll be able to incorporate learning into the next stage. 

It's pretty much impossible for those involved in a CRM implementation to fully articulate all 
their requirements at the start of the project. Even a good project plan is likely to miss a 
number of things. Despite your best intentions, as the project progresses you'll make some 
mistakes and have to revise some decisions. 

Make sure that you plan time for staff to have hands-on experience of the system and enable 
them to provide feedback (both positive and negative) that you can incorporate as the project 
progresses. The importance of this cannot be overstated. If staff are having problems or 
concerns and feel that these are unheard, they will resent the new system and your project 
will have more difficulty succeeding. 

If you are planning to use CiviCRM for any large or mission-critical events, make sure that you 
have allowed adequate time for staff training and testing. 

Training is more manageable 

CiviCRM's range of functionality can be overwhelming at first (especially to the less technically 
minded). Remember that staff who were not involved in the project's early stages will need to 
have concepts explained clearly to them. 

Trying to cover everything in one training session probably won't be effective. Your staff will 
need time to get on board and digest the new ideas. Instead, try smaller training sessions, 
introducing concepts and specific functionality, followed by periods of testing, piloting and 
feedback. 

Resistance to change is reduced 

Introducing a new CRM is likely to cause changes in work flow and processes at the 
organization. These changes may be 'political' or they may be technical. Either way, a lot of 
change at the same time is usually difficult and stressful. 

To alleviate this, give staff time to accept and support each change. Show them how the new 
system will make their work easier. If possible at the beginning of deployment, focus on simple 
tasks first and then follow up with difficult tasks. 

TEST SYSTEMS 



Setting up a test database is a great way to introduce a new system. Using real world data in 
a test system gives staff a chance to experiment with CiviCRM without fear of any 
consequences. It also lets staff test functionality and learn what works and what doesn't. 

PILOTS 

Organisations with existing processes and systems may like to try a pilot. This would work 
well, for example, for organisations that organise a lot of events. CiviCRM could be used to 
manage one of these events and the learning fed back into the development process. 

TAKING MANAGEABLE STEPS 

There are a few tried and tested ways to break up deployments. It's unlikely that all of these 
will make sense for your organisation, but applying the general principle might be helpful. 

Introduce your CMS independently of the CRM. The difference between the two isn't 
immediately obvious if they are presented together. Understanding the difference between 
the two helps staff understand the architecture of both, and the implications of them being 
linked together. 

Start by allowing only staff to access and edit data (that is, don't give your constituents 
access to the data via the CMS). Although the ability of constituents to update data is a key 
advantage of using CiviCRM with a CMS, it is a significant conceptual leap which may introduce 
the extra task of monitoring changes made by constituents. Consider introducing constituent 
access to data via the CMS after staff are more familiar with the new system. 

Hopefully these steps will help you and your organisation have a successful and rewarding 
experience with implementing your project. 
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THINKING ABOUT YOUR DATA 



It takes time and patience to figure out where to put data in a new system, even if you're 
starting fresh. It's even harder if you have pre-existing data. The purpose of this chapter is to 
familiarize you with how data is managed in CiviCRM and to get you thinking about where to 
"plant" your data in CiviCRM. 

GARBAGE IN.. .GARBAGE OUT... 

CiviCRM depends upon the integrity of the data that is stored in it: where it is and what 
"shape" it is in. You might be familiar with the expression: "garbage in... garbage out". The 
following are examples of data that is, for one reason or another, "garbage". 

• Inconsistencies in data entry. Recording a state for one person as California and for 
another as CA makes it difficult when you try to search for everyone in that state. Use 
one or the other. Being inconsistent makes it difficult to find specific data, and results in 
"ugly" reports and mailing labels. 

• Out-of-date information is also "garbage": If you've sent mailings that have been 
returned to you either because the address was completely wrong or because the 
person had moved to a different address, and you haven't updated the address data for 
those contact records, then the address information for those contacts is also garbage. 

• Data that isn't well organized results in sending duplicate mailings. For example if all 
correspondence from John and Jane Smith indicate that they are a couple living in the 
same house, yet you continue to keep separate records with no indication that they are 
part of the same household, then you will continue to send duplicate mailings. 

Clean data is data that appears in the same way consistently throughout the system. 
Even making a poor choice of the 'standard' for how to store data for a particular field is 
better then storing it in a haphazard way. 

Organized data makes it easy to find the contacts that you need for a mailing, an event or 
any other purpose. 

Whether you're moving old data into CiviCRM or starting from scratch, take time before you 
define data fields to think through the way your data reflects your organization's work and 
take time to standardize the way that certain data is recorded in your system. Also take time 
to learn about the purpose of the fields in the new system so that you will enter or import 
data into the right place and in a consistent manner. 

Choosing and structuring your data in CiviCRM 

If you have pre-existing data that you want to put into CiviCRM, you might find it useful to 
think of a process like moving your house or apartment. Part of the packing process should 
include asking "Do we really need this?" People use apartment moving as a chance to say, 
"This stuff is too old; let's trash it and get some new stuff once we have moved in." 

To apply this metaphor to your data, look for fields that have no purpose, such as old 
organizational divisions that you've abandoned or office locations in a facility you no longer 
occupy. 

Many fields will have continuing value. One organization, for instance, in a financial pinch 
decided to use an old list of founding donors who had not given money for many years. It 
turned out that these "lapsed" donors still had strong emotional ties to the organization that 
they had founded and they came to its financial rescue. So in that case saving old data was 
crucial. 

While you're evaluating data, place it into a structure that allows you to manipulate it later. In 
our moving metaphor, this is like packing things into boxes based on which room you'll want 
them in after you move. There are several CiviCRM concepts you can apply at this stage, even 
if you don't know CiviCRM very well: 



• CiviCRM's basic, top-level item of information is the record and there are three record 
types: individual, household and organization 

• The record type determines which fields appear when someone views a record of that 
type. For example: you won't see Organization name in a household-type record 

• "Contact" is the term that is used to refer to all record types (individuals, households 
and organizations), but when you add a new record, or do an import, you must specify 
the record type. 

• A record might have data such as donation amounts and dates and events attended. 
When it comes to importing the data, you will need to first import the contact and then 
import the donation or participation information into CiviContribute and CiviEvent. 

Of course, if you're moving into a house you don't know very well, or one that you've seen 
only in plans or photos, you may find when you get there that some stuff you had intended 
for the living room would go better on the landing or in the hall. So part of the process is 
ensuring that you leave options open to move things around until you have properly settled in. 

It is strongly recommended that you analyze your data needs as described here before you 
begin defining data groups and fields through the CiviCRM interface. Start by making a list of 
each existing data field that you want to transfer and any new fields that you wish to start 
tracking in CivCRM. Compare each field with CiviCRM's core contact fields and try to find one 
that is the appropriate match for your data field. If you do not find an appropriate match in 
core fields, then create a custom field or a tag: core fields have a specific purpose in the 
system and only data that matches that purpose should be present. You can then classify the 
remaining fields as custom data fields, groups, or tags. 

What does CiviCRM offer? 

At its core, CiviCRM has a number of predefined data fields. These fields should always be 
used before creating custom fields because core fields are tied to specific inbuilt functionality. 
Core fields include basic information about the contact such as: 

• Name, nickname, greeting, title 

• Website, email addresses, phone numbers, IM account name 

• Addresses 

• Communication preferences 

• Demographics 

Before continuing with the analysis of your existing data or required data needs, you should 
familiarize yourself with the core contact fields available. You may do this by viewing a contact 
in CiviCRM and clicking "edit," which will display all available fields for that contact type. At a 
later date you may choose to disable certain fields that are not used by your organization. 
This is configurable through the Administer CiviCRM » Global Settings pages. 

Wherever possible, you should seek to use the pre-defined contact fields before examining 
other options. However, it is very likely that your needs extend beyond the options available 
in the core contact fields, since you may want to capture information about individuals' or 
organisations' characteristics, interests, history, etc. In such cases, you can use CiviCRM's 
custom data tools or use the Groups or Tags options. 

For example, if your existing data includes a list of people who are on a Committee, you could 
replicate this information in CiviCRM through either a custom data field, or by adding those 
contacts directly into a Group. 

EXTENDING CORE DATA 

It is very likely that the information you want to collect extends beyond the predefined fields 
that come with CiviCRM. 

Custom data tools provide you the ability to create as many additional fields of varying types 
as you need, and to group and display them based on your preferences. These fields can then 
be used in Profiles to expose or collect data through website forms. 



If you have already undertaken a data structure analysis, you have identified the fields you 
need in addition to those that come predefined in CiviCRM. You should have also reviewed the 
function and benefits of Groups and Tags, as the characteristics of these tools may be better 
suited for certain data management and organizational needs than custom data fields. 

Custom data sets 

Custom data fields are organized into sets referred to in CiviCRM as custom data groups (to 
avoid confusion with Groups within this manual we refer to them as 'sets'). These custom data 
sets can be associated with all contact types, with a specific contact type (e.g., Individuals), 
with a specific component (CiviMember, CiviEvent), or with other elements such as 
Relationships and Groups. 

NOTE: It is important to carefully consider what record type your custom data group will be 
applied to. You will not be able to change the record type after creating your data group. 

When creating field sets you should ask: 

• How will these fields be used? 

• What types of contacts or records will these fields be appropriate for? 

• Will they have broad applicability, or are they relevant to a specific contact type, event, 
contribution type, etc.? 

Taking the time to think through these questions helps keep your application screens as 
relevant and clear of superfluous fields as possible. For example, if your field set contains 
contact characteristics such as a field for the "color of eyes," you would associate them with 
the "Individual" contact type, rather than the generic "Contacts" option, as this field would be 
irrelevant to Organization and Household contact types. 

Depending on how many custom data fields you are creating, you should also consider grouping 
the fields topically. For example, you may have 20 custom fields that will all be associated with 
Individual contacts, 12 of which are fields relating to an online membership directory. Rather 
than group all 20 fields in a single custom data set, you may want to split them into two 
groups — one for the directory-related fields, and a second for more general "Individual 
Details." 

Configuring custom data sets 

You create custom data sets and fields through Administer CiviCRM » Custom Data » New 
Group of Custom Fields. Using this form, you identify the title of the data set, specify what 
type of records the data set will be used for, select the display characteristics, and enter help 
text. 
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Group Name 

For 'inline' display custom groups, this name appears as the legend of the field set. If this 
group uses the 'tab' display style, the name is used for the navigation tab label. 
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There are many options in terms of how specifically you can define what the Data Fields will 
be used for. You can use this option to ensure that the fields are only available in the relevant 
places. The full set of options include: 

• Activity: May be assigned to all activities or to a specific activity type, such as Meeting 
or Phone Call. 

• Contacts: Applied to all contact types. 

• Contributions: May be assigned to all contributions or to a specific contribution type, 
such as Donations or Event Fees. 

• Events: Applied to the actual event itself, not the participant registration record, and 
can be assigned to all events or a specific event type (e.g., Conference or Fundraiser) 

• Grants 

• Groups: Displayed in the Group Settings (note that these fields are not searchable) 

• Household: Applied to household contact types only. 

• Individual: Applied to individual contact types only. 

• Memberships: May be assigned to all membership records or to a specific membership 
type. 

• Organization: Applied to organization contact types only. 

• Participants: Applied to the participant registration record. There are three options for 
participant fields — general fields applied to all registration records, role-type fields 
assigned to a specific participant role, and event participant fields assigned to a specific 
event. 

• Pledges 

• Relationships: May be assigned to all relationship records or to a specific relationship 
type, such as Spouse of or Employee/Employer of. 

As you can see, custom data sets and fields provide tremendous flexibility and control over 
your data needs, allowing you to create and assign fields to virtually every organizational 
element within CiviCRM. 



Multiple Records 

Data sets usually only have a single set of data associated with a contact record - for 
example, a person has blue eyes or a person has brown eyes. However, there are times when 
you may need to track multiple sets of records for a single contact. CiviCRM provides this 
functionality for custom data sets assigned to contacts (all contact types or a specific type). 
For example, you may want to track a person's post-secondary educational history, collecting 
information about the schools they attended, date of graduation, degree level, and area of 
study. A single person may have multiple records tracking their undergraduate and post- 
graduate work. 

To make use of this option, select the "Does this Custom Data Group allow multiple records?" 
option when creating the custom data set. Note that this option: 

• can only be applied to a data set, not to a particular field 

• the data set must be displayed in a tab (inline display is not supported) 

• can only be used for Contacts, not for Activities, Contributions, etc. 

• cannot be used in Profiles, such as those used for Events 

• cannot currently be exported. 

Display Style 

Data field sets are either displayed 'inline' on the contact summary page (the Summary tab), 
or as a new Tab sitting along the top of the contact record, along with Summary, Contribution, 
Group, Note etc. Select Tab' for less frequently accessed and/or larger sets of fields. NOTE: 
This setting applies to Custom Data sets used for Contact records only. Custom data sets 
used for components, relationships, or other resources, are always displayed inline. Also note 
that custom data sets configured to handle multiple records must be displayed in a tab. 

Other settings 

You can specify that you want the field set to be "collapsed" on initial display. If you check this 
box, then only the title for this field set is displayed when the page is initially loaded, because 
the fields are hidden. This is helpful for field sets that are less frequently used as it reduces 
how much screen real estate is used when the page opens. 

You can also set whether the field set is active and can provide explanatory text displayed 
above or below the field set. 

Custom Data Fields 

After defining your custom data set, you must create the actual data fields. 

As you work through the settings for each field, think carefully about how you want to display 
and use the information. Each field type provides unique characteristics regarding how the field 
displays, how data is stored, and how it can be searched. For example, using checkboxes 
rather than multi-select enables you to use OR as well as AND searches in Advanced Search. 
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Field Label 

This is a unique field name used in screen displays and when you export data. When using 
fields in a profile you can overwrite the Field Label - so choose names that make sense for 
administrators, and then give more user friendly names when exposing them in profiles. 

Data and Input Field Type 
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Select the type of data you want to collect and store for this contact. Then select from the 
available HTML input field types (choices are based on the type of data being collected). You 
can also specify the database field length here, where applicable. 



Alphanumeric (text or numbers) 

o Text (simple text form field) 

o Select (drop-down box; one selection) 

o Radio (list of options; one selection; note that there is a pre-built Yes/No data 
type) 

o Checkbox (list of options with checkboxes; multiple selections) 

o Multi-select (list of options in a single box; multiple selections using Control-Click) 
Integer 

o Text/Select/Radio 
Number 

o Text/Select/Radio 
Money 

o Text/Select/Radio 
Note (longer text; multiple lines) 

o TextArea (plain text, multi-line box) 

o RichTextEditor (multi-line box with WYSIWYG editor for html styling) 
Date (select dropdowns) (can include hours and mins) 
Yes or No (radio buttons) 
State/Province (selection options as defined in global settings) 

o Select dropdown (single selection) 

o Multi-select box 
Country (selection options as defined in global settings) 

o Select dropdown 

o Multi-select box 
File (browse to select and upload file) 
Link (active hyperlink) 
Contact Reference (link to an existing CiviCRM contact) 



Multiple Choice Options 

For field types that involve selecting from a set of multiple options - Select, Radio, Checkbox 
and Multi-select - you are given the option either of using an existing set of options which 
you've already created for another custom field or of creating a new set. 

If you choose to use the same set of options for several fields, then you will be notified when 
making any changes that this will affect an option set that is used by several fields. 

When you create a new set, you have the option of initially entering up to ten multiple choice 
options in a table. If you need more than ten options, you can create an unlimited number of 
additional choices after saving this new field by using the Edit Multiple Choice Options link. 

You may modify the label, order and active status of any multiple option at a later date 
through Custom Data » View and Edit Custom Fields » Edit Multiple Choice Options. 

If desired, you can also mark one of the choices as the default option. The option 'label' is 
displayed on the form, while the option 'value' is stored in the contact record. The label and 
value may be the same or different. 

Inactive options are hidden when the field is presented. 

Order 

As the name would suggest, the order field controls the order in which the fields appear. You 
may assign the order in the field edit form, or use the up/down icons on the main field listing 
table to adjust the field presentation. By default, new fields appear at the bottom of the field 
list within a set. 

Default Value 

Where applicable, you may designate a default value for a field. Note the format required for 
date fields (YYYY-MM-DD). 

Field Help 

In most cases, a field's name is self-explanatory in describing the purpose of the field. But in 
those cases where there is some ambiguity, or where you wish to help regulate how a certain 
field is used, you may enter help text. The help text appears below the form field. Note that 
the text identified here appears in all uses of the field in administration pages and is inserted 
as the default help text when fields are assigned to a profile. When used in a profile, the help 
text may be removed or changed without impact on the original custom field definition. 

Required 

As you begin defining each of your custom fields, you will undoubtedly come across some fields 
that you wish to designate as a required field. By selecting this option, you ensure that 
whoever is completing the form must provide a value for this field before submitting the form. 
Failure to do so will result in an error message directing the person to complete the required 
field(s). 

Is this Field Searchable 

CiviCRM's advanced search page is a powerful tool for running complex queries on your 
records. The tool includes a custom field panel which displays custom fields configured to be 
searchable, as defined in this option. As with other areas of CiviCRM, it is worth thinking 
through how you will use the particular field you are defining. While you may be tempted to 
simply mark every field as searchable, doing so may unnecessarily clutter the advanced 
search custom field panel, when in fact certain fields will likely never be used in that way. You 
may toggle this option on or off at any time, so don't be overly concerned about arriving at a 
final decision during this initial field-definition stage. 

Active 

The "active" option determines if the field is disabled or enabled within the CiviCRM interface. 
Disabling a field does not remove the data from the system — it simply hides the field from the 
contact interface. 

While this option may seem rather mundane and obvious, it can perform very valuable 



functions when managing your data, especially if you are migrating from an existing database 
system. 

For example, you may have certain fields in your existing database that you would like to 
transfer to the new system for historical data keeping purposes but plan to then deprecate or 
migrate to a new data structure in CiviCRM. Suppose you are importing membership records 
from an MS Access database. Each record in Access has a unique ID (key) field, which has no 
direct benefit in CiviCRM. Rather than ignoring it altogether, you could create a custom field to 
hold the value, import the records, and then disable (un-activate) the field, thereby hiding it 
from view and minimizing the interface clutter. Though not visible to users, the field value is 
stored in the system and can be referenced at a later date if you need to — for instance if you 
ever needed to investigate archived data for a possible discrepancy or compare the field value 
with a printed record. 

View Only 

The last option on the field creation form allows you to designate a field as visible but 
uneditable. There are two general uses for this field: to store data imported from another 
system that you want available for reference to the user, but do not want them to be able to 
modify; or as a data container that is controlled through a custom PHP hook rather than 
through the user interface. CiviCRM has a number of hooks defined that allow developers to 
modify data, as well as customize forms and screens, without modifying the CiviCRM 
codebase. Visit the documentation online for more specific information about available hooks 
and how to implement them. 

After completing the field configuration options, click save to record the field and return to the 
field listing for your current field set, or click "save and new" to save the field and begin 
defining a new field. 

With the exception of the data and input field type selection, all of the configuration options 
may be modified after your initial creation of the field. You may also find it useful to preview 
your custom fields, as well as the set of custom fields as you are defining them. This is 
particularly useful for checking the layout of radio button and checkbox fields with a large 
number of choices. 

Choosing between custom fields, groups and tags 

Data fields, groups, and tags are three main ways to associate information with contacts. 
While it can be tempting to just create a custom data field for every attribute of your data, 
take time to learn about the alternatives. They offer powerful functionality that you may miss 
out on if you rely only on custom data. Furthermore, using data fields for information stored 
more appropriately as groups or tags can slow your system. Finally, proper use of groups and 
tags makes it much easier for administrative staff to maintain the records. 

Some tips that may help you choose : 



• Data that can take a wide range of values, such as a person's address or biography, 
should be stored in an alphanumeric custom data field 

• Custom Data fields can be grouped and displayed on their own tab on the contact's 
record 

• As the name implies, Groups are used to group contacts. For instance, you'll probably 
assign board members to one group, staff to another, volunteers to a third, and so on. 
If you use Drupal, you can assign permissions based on group membership. You can also 
define a group that CiviCRM automatically adds contacts to and deletes contacts from, 
based on some characteristic. This feature is called a Smart Group. 

• If you plan to use CiviMail for mass mailings and you want certain contacts to get a 
particular mailing, those contacts must be assigned to a Group. For instance, you may 
want a press release to go only to certain contacts; those contacts should be assigned 
to a particular group. This group could be a Smart Group, 

• Both Tags and Groups can be structured hierarchically. For instance, a group/tag labeled 
Regions can have a subgroup/subtag for each geographic region your organization covers. 
(See "Case study in hierarchical tags" later in this section.) 

• Tags support more powerful search options than data fields or groups. For instance, 
visitors can search through multiple tags with both AND and OR operators. Data fields 
support only lists of words (which is effectively the same as an AND operator), except 
for fields represented as checkboxes, which support OR operators. 

• Tags have a more sophisticated user interface than data fields or groups The interface 
allows the visitor to add and remove tags without reloading the page in edit mode. 

• Custom Data fields can be assigned to a specific record type (e.g., only households), 
whereas tags will be assigned to all types once the tags are defined. 

WARNING: Once you choose a record type in which your custom data set appears, you can't 
change the type. If you find later that you need to change the record type, you either have to 
delete and recreate the data set or get someone with database experience to look at the 
representation of the record types in your underlying database and copy the data manually to 
the new record type. 

Relationships 

Relationships are another way of capturing data for information that connects one contact to 
another. Go to Administer CiviCRM » Relationship Types to familiarise yourself the standard 
relationships included in CiviCRM. You can define additional types of relationships as needed. 

Prior to importing data, you will need to pay attention to how you handle relationships such as 
employer-to-employee and household-to-individual. During the import you can create these if 
you understand what needs to be done. 

Relationships are also the basis for providing inherited memberships, which is covered in more 
depth in the section on Memberships. 

Creating Your Data Structure in CiviCRM 

Once you have completed the analysis of your data needs, you may want to begin creating 
your custom data groups and fields, groups, and tags. Take time to read the sections and 
documentation that further details how these functions work, but in summary: 

• For custom data groups and fields, go to Administer CiviCRM and select "Custom Data" 
in the "Customized" section 

• For groups, click on CiviCRM Home and the select "Manage Groups" 

• For tags, go to Administer CiviCRM and select "tags" in the "Option Lists" section 

When creating a custom data group field you must decide how you want it to be displayed on 
the screen: this is what the user/guest will see. A variety of "web form elements", such as 
text box, date, radio buttons, checkboxes, or drop-down selection list, are available. Just pick 
the one that suits your needs. 

Next Steps 

After you have: 



• analyzed your existing data 

• cleaned it up by standardizing and organizing it 

• removed duplicate records 

• decided what fields in CiviCRM you will be using 

• created any custom fields, groups, and tags that you will need in CiviCRM 

• decided the number and layout for your import files 

You are ready to import your existing data. 



15. 



INSTALL & CONFIGURE 



Before reading further, please be aware that much of the information contained here is 
intended for technicians and may be difficult to understand if you have little or no experience 
in setting up web applications. If you don't understand this topic you may wish to either seek 
help, or point your organisation's technical staff to this material. 

INSTALLATION 

CiviCRM must be installed on a computer that has been configured with a web-server, PHP, 
and MySQL. Some people prefer to try out CiviCRM on their own local computer before 
installing it on a dedicated web-server. If you are doing this and don't have the pre-requisites 
mentioned above ou can download packages such as Wamp, Xampp, Mampp and Lamp off 
the internet which will quickly install Apache web-server, PHP and MySQL. (The first two are 
for Windows and the second two are for Macintosh and Linux respectively). BitNami offers 
excellent installers for Windows, Mac (Intel & PPC), and Linux. 

Once you are ready to start using CiviCRM in your organization you'll probably want CiviCRM to 
be available on the internet. However, some organizations only want internal staff to have 
access. In this case they may choose to install CiviCRM on an intranet or internal network. 

Before you can begin the installation process, you will need to decide whether you are going to 
use CiviCRM integrated with Drupal or Joomla, or in standalone mode. Refer to the 
appropriate section in the online CiviCRM Installation Guide for the latest system 
requirements and specific installation steps: 

http://wiki.civicrm.org/confluence/display/CRMDOC/lnstallation+and+Upgrades 
A Note About Upgrades 

New versions of CiviCRM are released two or three times a year - and you will need to apply 
upgrades to your CiviCRM site periodically in order to take advantage of new features and 
improvements. It's important that you plan for the resources (people and time) required to 
apply upgrades to your site. You need to plan on testing upgrades on a copy of your live site 
to make sure the process runs smoothly. It's critical to make backups of your site and 
database prior to running an upgrade. 

Refer to the appropriate section of the online CiviCRM Installation Guide for specific upgrade 
procedures. Be sure to select the procedure that is targeted for the environment you are 
running (Drupal, Joomla or Standalone), and the version you are upgrading to. 

For example, if you are looking at the online Installation Guide, refer to Upgrade Joomla Sites 
to 2.2 if you are running CiviCRM 2.1 with Joomla. 

CONFIGURATION 

Now that you have CiviCRM installed and running on your web-server, it's time to review the 
initial configuration tasks which allow you to customize CiviCRM for your organization. 

You can easily access each of the configuration screens described below from the 
Configuration Checklist. Login to your CiviCRM site and navigate to Administer CiviCRM » 
Configure » Configuration Checklist. This section will cover the general tasks, while 
component-specific configuration will be covered in each component section. 



Site Configuration 



Localization 



Domain Information 



Localization settings Include user language, default currency and 
available countries for address Input, 

Organization name, email address for system-generated emails, 
organization address 



Viewing and Editing Contacts 



Site Preferences 

Address Settings 
Mapping and Geocoding 
Miscellaneous 



Configure screen and form elements for Viewing Contacts, 
Editing Contacts, Advanced Search, Contact Dashboard and 
WYSIWYG Editor. 

Format addresses in mailing labels, input forms and screen 
display. 

Configure a mapping provider (e.g. Google or Yahoo) to display 
maps for contact addresses and event locations. 

Contact search behaviors, RECAPTCHA configuration. 



Sending Emails (includes contribution receipts and event confirmations) 



Outbound Email 



From Email Addresses 



Settings for outbound email - either SMTP server, port and 
authentication orSendmail path and argument. 

Define general email address(es) thai can be used as the FROM 
address when sending email to contacts from within CiviCRM 
(e.g. info@example.org) 

Online Contributions / Online Membership Signup / Online Event Registration 



Payment Processors 



Permissions for 
Anonymous Users 



Select and configure one or more payment processing services 

for online contributions, events and / or membership fees. 

You will also need to change Drupal permissions so anonymous 
users can make contributions, register for events and / or use 
profiles to enter contact information, fleam more...) 



Note : It's helpful to understand the term token before you continue reading this section. 
Tokens are special blocks of text which refer to a specific field in your database. They are 
used to control what fields are included in address display and mailing labels, and can also be 
used to personalize emails. This is described in more detail below. If you've used "mail merge" 
in your word processor, then you've already used tokens. 

CiviCRM uses tokens to control which fields are included in mailing labels and address display, 
and how they are arranged. Tokens are always surrounded by curly brackets, and include the 
record type followed by the field name. EXAMPLE: {contact.street_address}. Address values are 
taken from the contact's primary location. 

Tokens are skipped when they refer to a field that is empty for a particular contact. 

EXAMPLE: The default Individual Name Format includes {contact.middle_name}. If a contact 
doesn't have a middle name, that token is skipped. 

EXAMPLE: The default Mailing Label format includes {contact.supplemental_address_1} on a 
separate line. If there is no supplemental address for a particular contact, that entire line is 
omitted - there will NOT be a blank line in the label. 

LOCALIZATION 



Localization involves adapting CiviCRM for use in a specific country or language by translating 
the text displayed on the screen and setting region specific formats for dates and money 
(including currency). By default CiviCRM is "localized" for the United States. If you are using 
CiviCRM in a different country or countries, or you need to store contact addresses in 
countries other than the United States, or you want to use CiviCRM in another language, you 
will need to review and update the values on this screen. 



CiviCRM has been translated into a number of different languages. These translations are 
contributed by community members - so your first step is to determine if a complete 
translation exists for the current version by visiting the Translation Server home page at 
http://translat ions, civicrm.org/ . If you find a completed translation, you can download it and 
select it on this screen. Otherwise you will need to consider whether you have resources for 
contributing a translation. 

It is also possible to configure your site to support multiple languages. In this mode, your users 
will be able to choose from a list of available languages after logging in. You can also create 
and store multi-language versions of text that is added by your users. Examples include 
custom field labels, online contribution page, campaign information, and event descriptions. 

Further reading: 

Localization overview - http://wiki.civicrm.org/confluence/display/CRMDOC/CiviCRM-l-Localisation 

DOMAIN INFORMATION 

Use this screen to enter identifying information for the organization or entity which "owns" 
this CiviCRM installation. The organization name and address are used to identify your 
organization in CiviMail mailings (when you include the domain.name and domain. address 
tokens). 

You should also enter a valid email address that belongs to your organization which will be 
used as the FROM email in system-generated (automated) emails. 

VIEWING AND EDITING CONTACTS 

This screen allows you to modify the screen and form elements for the following tasks: 

• Viewing Contacts - Control the tabs that should be displayed when viewing a contact 
record. EXAMPLE: If your organization does not keep track of 'Relationships', then un- 
check this option to simplify the screen display. Tabs for Contributions, Pledges, 
Memberships, Events, Grants and Cases are also hidden if the corresponding component 
is not enabled 

• Editing Contacts - Control the sections that should be included when adding or editing a 
contact record. EXAMPLE: If your organization does not record Gender and Birth Date 
for individuals, then simplify the form by un-checking Demographics. 

• Advanced Search - Control the sections that should be included in the Advanced Search 
form. EXAMPLE: If you don't track Relationships - then you do not need this section 
included. Simplify the form by un-checking this option. 

• Contact Dashboard - This dashboard can allow your constituents to view the groups 
they are subscribed to, their contribution history, event registration information and 
more. You can control the sections that should be included in the dashboard here. 
EXAMPLE: If you don't want constituents to view their own contribution history, un- 
check that option. 

• WYSIWYG Editor - Select the HTML WYSIWYG Editor that is provided for fields that 
allow HTML formatting (such as the introductory section for your online contribution 
pages). You can choose either FCKEditor or TinyMCE. It's a good idea to try out both and 
see which is more comfortable for you and your users. 

Address Settings 

CiviCRM allows you to modify the default fields for adding and editing contact and event 
address data. You can also change the address field layout used for screen display and mailing 
labels. Review the out-of-the-box defaults by adding a new contact record and noting the 
address fields provided on the form. Save the record and note the order in which the fields 
are displayed on the Contact Summary screen. If you plan on generating mailing labels for 
contacts - you should also review the label layout (select Mailing Labels from the -more 
actions- drop-down after doing a search using the Find Contacts menu option). 

After reviewing the default fields and layouts - review the Address Settings screen and make 
changes as needed. 



• Mailing Labels - Modify mailing label formatting here. The default format is: 

{contact . contact_name } 

{contact . street_address } 

{contact . supplemental_address_l } 

{contact . supplement a l_address_2 } 

{contact . city }{ , } {contact . state_province } { } {contact .postal_code } {contact . 

You must include the special {contact_name} token here in order to include the contact 
name in your labels. If the label is for an individual, the Individual Name Format is used 
(see the next bullet item). For organizations - the Organization Name is used. For 
households, the Household Name is used. Users will be able to select from a variety of 
label types corresponding to the label manufacturer code when they generate the labels 
from a list of contacts. It's a good idea to test your format with the type of label and 
printer you plan on using to verify spacing. 

• Individual Name Format - Modify the order and the specific fields used for individual 
contact names when they are included in mailing labels. The default format is: 

{individual_prefix}{ } { first_name } { } {middle_name} { } { last_name} 

• Address Display - Modify the layout for contact and event location addresses when 
displayed on CiviCRM screens. The default format is: 

{contact . address_name } 

{contact . street_address } 

{contact . supplemental_address_l } 

{contact . supplement a l_address_2 } 

{ contact . city } { , } {contact . state_province } { } {contact .postal_code } {contact . 

[TIP] This format applies to event locations, despite the use of the contact, record type 
in the layout. The {contact. address_name} field is particularly useful for events where 
you need to include a location name (e.g. "Smithson Hall"). [/TIP] 

• Address Editing Fields - Modify the available address editing fields here. You can hide 
fields that you don't plan on using in order to simplify the forms. EXAMPLE: If you don't 
plan on recording OpenlDs for contacts, you can uncheck that field. 

• Number of Locations - You can control the maximum number of different 
locations/addresses that can be entered for each contact. The default value is / location. 
If you plan on recording Home and Work addresses for some contacts, for example, 
then increase this number here. 

• Address Standardization - CiviCRM includes an optional feature for interfacing to the 
United States Postal Services (USPS) Address Standardization web service. You must 
register to use the USPS service at http://www.usps.com/webtools/address.htm . If you 
are approved, they will provide you with a User ID and the URL for the service. The URL 
provided by USPS will not be prefixed with "http://". When entering this URL into the 
CiviCRM settings field, you must prefix it with "http://". 

MAPPING AND GEOCODING 

CiviCRM includes support for both the Google and Yahoo mapping services. These services 
allow your users to display contact addresses and event locations on a map. To enable this 
feature, select your mapping provider and obtain a 'key' for your site from that provider. Map 
coverage outside of the United States may vary between providers - so it's a good idea to 
investigate coverage if you expect to store a significant number of non-US addresses. 

Once a mapping provider is enabled, your contact and event records will be automatically 
geocoded (the latitude and longitude for that address is inserted) as you add or edit address 
data. 

VERSION CHECKING, SEARCH BEHAVIORS AND CAPTCHA 

Use the Miscellaneous Settings screen to configure and control the following behaviors: 



• Version Checking and Statistics Reporting - This feature automatically checks 
availability of a newer stable version of CiviCRM. New version alerts are displayed on 
the main CiviCRM Administration page. Statistics about your CiviCRM installation are also 
reported anonymously to the CiviCRM team to assist in prioritizing ongoing 
development efforts. The following information is gathered: CiviCRM version, versions of 
PHP, MySQL and framework (Drupal/Joomla/standalone), and default language. Record 
counts (but no actual data) are also reported. You can set this field to No if you are not 
comfortable with having this information reported for your site. 

• Attachments - You can increase or decrease the maximum number of files (documents, 
images, etc.) which can attached to emails, activities, and grant records. The default 
value is 3. 

• Contact Searches - 

[TIP] A wildcard character is a special character that can be used to substitute for 
any other character or characters in searches. CiviCRM allows you to use the 
percent - '%' - character to substitute for zero or more characters, and the 
underscore - '_' - character to substitute for any single character. Wildcards are 
useful for broadening your search results. 

EXAMPLE: Typing Volunteer /)' as your Activity Subject will match any record 
whose subject contains 'Volunteer' + any other words (e.g. 'Volunteer for Open 
House'). [/TIP] 

o Automatic Wildcards - By default, wildcards are automatically added when 
users search for contacts by Name. EXAMPLE: Searching for 'ada' will return any 
contact whose name includes those letters - e.g. 'Adams, Janet', 'Nadal, Jorge', etc. 
Disabling this feature will speed up searches significantly for larger databases, but 
users must use wildcard characters for partial name searches (e.g. '%' or '_'). 

o Include Email - By default, email addresses are automatically included when users 
search by Name. Disabling this feature will speed up searches significantly for 
larger databases, but users will need to use the Email search fields (from 
Advanced Search, Search Builder, or Profiles) to find contacts by email address. 

o Include Nickname - By default, nicknames are automatically NOT included when 
users search by Name. Change this value to Yes if you want nicknames to be 
included. 

o Smart group cache timeout - Smart groups are basically saved searches. The 
list of contacts for each smart group is cached in the database in order to avoid 
running the saved search every time you access a smart group. This field 
determines the number of minutes to maintain this cache before refreshing it. 
The default value of means the cache is emptied immediately when any contact 
is edited or a new one is added. If your contact data changes frequently, you may 
want to try setting this to a value of 5 minutes (or longer) to reduce processing 
load on your server. 

• reCAPTCHA - reCAPTCHA is a free service that helps prevent automated abuse of 
your site by requiring users to read a random pair of words and type them into the 
form. To use reCAPTCHA on public-facing CiviCRM forms: sign up at recaptcha.net : enter 
the provided public and private reCAPTCHA keys here: then enable reCAPTCHA under 
the Advanced Settings section in any Profile. 

[TIP] If you want to use reCAPTCHA protection for online contribution, membership 
signup or event registration forms - then you'll need to configure a Profile with 
reCAPTCHA enabled, and then include it in those forms. [/TIP] 

SENDING EMAILS 

CiviCRM will use the default FROM address defined here when sending automated emails. If 
you've already entered an email address in the Domain Information screen, that address will 
be listed here. 



Label 


value Description 


Order Default Reserved Enabled? 


"Client Services" 


2 Use this for 


1 [x] No Ves 


<clientservices@example.org> 


all general 






emails. 





When users send an email using CiviCRM, their primary email address is used as the FROM 
address by default. However, they can also select one of the general email addresses defined 
here as an alternative. 

Outbound Email 

If you are sending emails to contacts using CiviCRM then you need to enter settings which 
allow CiviCRM to connect to your mail server. This includes sending receipts to contributors, 
sending confirmations to people registering for events, and using CiviMail to send bulk mailings. 

CiviCRM supports two different methods of connecting to a mail server: SMTP (Simple Mail 
Transport Protocol) OR Sendmail. Each method requires that you enter specific settings. If 
you're unfamiliar with these terms, or unsure of the correct values for these settings, check 
with your system administrator, ISP or hosting provider. 

You should always send a test email when you enter or modify the settings on this screen. 
Simply click "Save and Send Test Email". An email will be sent to the email address associated 
with your user login. The FROM email address will be the default FROM address you've 
configured in the previous section. 

(save ) (cancel ) ( Save & Send Test Email ) 

If CiviCRM is unable to send the test email, you will see a message on your screen with the 
specific error and some suggestions for trouble-shooting the problem. 

Note: If you do NOT want users to send outbound emails from CiviCRM at all, select "Disable 
Outbound Email". However, if you disable outbound email, and you are using Online 
Contribution pages or online Event Registration - you will need to turn off the automated 
receipting and registration confirmation features (these are enabled by default). Otherwise 
your constituents will see error messages after they've completed a contribution or 
registration. 

PAYMENT PROCESSORS 

Payment processors are companies that handle credit card transactions for merchants and / 
or non-profit organizations and transfer funds to the organization's bank account. If you plan 
on using CiviCRM to accept online contributions, online membership signup and renewal or 
online event registration, then you will need to select and configure a payment processor for 
your site. 

CiviCRM includes support for several different processors, and provides a way for 3rd party 
developers to add support for additional processors based on their clients' needs. Each 
processor has their own pricing structure and features, and you will want to investigate each 
available option to determine the best fit for your organization. Refer to the Fundraising 
section for a list of factors to consider in selecting a processor. 

The actual steps involved in configuring and testing your payment processor connection are 
different for each processor. For more information, visit: 
http://wiki.civicrm.org/confluence/display/CRMDOC/CiviContribute+Payment+Processor+Configuration 

PERMISSIONS FOR ANONYMOUS USERS 

Note: This section applies to Drupal sites only. 



If you are using CiviCRM with Drupal, you will need to review user permissions to ensure 
that people can get to your signup forms, contribution pages, membership pages and event 
registration pages. 

You must be an administrator for your Drupal site to review and modify user permissions. 
Login to your Drupal site, and navigate to Administer » User Management » Permissions. 

anonymous 
Permission 

user 



civlcrm module 




make online 
contributions 


« 


profile listings and 
forms 


* 


register for events 


a 



Then review each of the permissions listed below. You should enable them for the 
anonymous user role if you want these features to be accessible to people who are visiting 
your site but are NOT logged in: 

• Make online contributions: 

If you plan to use CiviContribute and want to allow online contributions, enable this 
permission by checking the box. 

• View event info and Register for events: 

If you plan to use CiviEvent and want to allow online event registration, enable BOTH of 
these permissions. 

• Profile listings and forms: 

If you want to either collect contact information from constituents and/or expose a 
searchable directory using a profile, you must enable this permission. 

• Access all custom data: 

You must enable this permission for any role which you want to view or edit custom 
data fields. This permission sounds like one that should be given out with care but in 
reality most sites give this permission to anonymous users as it is required for simple 
tasks like filling in information about themselves in custom data fields which you include 
in the event registration process. If your site uses Profile(s) which include custom fields, 
make sure the role(s) that need to access these Profiles have this permission. 

Now that you have reviewed all the basic configuration tasks, you're ready to begin exploring 
the ways in which you can record and use contact data. 
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CONTACTS AND THEIR DATA 



This section assumes that you are familiar with the basic concepts relating to CRM software 
and have spent time evaluating your organizations needs and your existing data. You will need 
to have access to a CiviCRM site, either your own site, or one of the public demo sites. 

CiviCRM enables you to store and access information about people and organizations. You can 
store information about staff, volunteers, funders, clients, coalition partners, members, donors 
or anyone else that is useful to you. 

There are three distinct contact types defined in the software: 

• Individual - any person you have dealings with. 

• Organization - this could be another non-profit, a company, a chapter of your 
organization, or even a committee. 

• Household - a family or group of people who share a physical location. 

CiviCRM provides different fields for each type of record. For example, gender only applies to 
individuals, not organizations or households. You can also define additional data that you want 
to collect and apply it to only one type. You could choose to create a custom data field to 
record the Chairperson or CEO's name and only apply this field to organizations. 

THE CONTACT SCREEN 

The best way to get to grips with contact management is to have Quick Search 

a look around the various screens that are used to store and 

display information about contacts. . . 

Search 



You can find a contact from the CiviCRM home page by entering 
part of their name or e-mail address in the quick search box. Or 
leave it blank and hit the Search button to find all the contacts in your database. 

CONTACT TABS 

Across the top of all contact records are a series of tabs. These will give you access to all of 
that contact's information. We are going to cover the contact summary tab here in some 
depth, and then look at the other tabs. 

If you think that some of the tabs are not useful and will not be used in your deployment, you 
can make changes (disable or enable chosen tabs) from Administer CivCRM » Global 
Settings » Site Preferences. If you don't see some of the tabs described below, you might 
need to enable them. 



Tabs are also dependent on the components which are enabled in your installation. For 
example, the Contributions tab will be hidden if the CiviContribute component is disabled. 



Summary 



Contributions 
Tags 



Memberships Everts 



Activities Relationships 



First Aid Skills 



Groups Notes | Tags | Change Log 

Mr Richard 1 Richardson Jr (Ricky) (Edit) (vCard) ( Print) 
(Delete J * View Contact Dashboard * View User Record 
Tags: Company 

Current Employer: ABC Association 



H Send an E mail Gf* Meeting 'S Phone Call © Other Activities 



B Home (primary location) 




Email: rik@test.com 


Household Address: 




Richardson Household 




1 Alpha St 




Betaville, 



B Communications Preferences 
Privacy: 



Method: 

Email Format Preference: Both 



SUMMARY TAB 



The summary tab gives you an overview of information about your contact. Here you will find 
names, addresses and contact details. The information on this page appears fairly 
straightforward, but take a closer look and you will find some pretty clever stuff is going on. 

You will notice that there are also four buttons on this screen. If you wish to change any 
information about this contact, you can go to the editing screen by clicking the Edit button. 
There is also a button to Delete the contact. If you with to print out the contact's details 
choose the Print button to take you to a print-friendly view of this contact's information. 
The last button, the vCard button, will bring the contact's details into your email client (you 
shouldn't do this if you want your emails to this person to be recorded in CiviCRM). 

There are also a range of actions you can take from this screen: 

• You can send an e-mail to given contact. The email will go to the address that is set up 
as their preferred e-mail address and will be recorded as an activity. You will be able to 
see this activity on their Activities Tab. 

• If 'Map this Address' is showing above the address, you can bring up a map (either using 
Google Maps or Yahoo Maps, depending on your system's configuration) showing you 
where this person lives. If it doesn't show on your screen, this feature hasn't yet been 
configured for your site. You can add map support from Administer CiviCRM » Global 
Settings » Mapping and Geocoding. 

CiviCRM includes a complete set of fields "out-of-the-box" to store basic contact information. 
They are usually referred to as built-in fields. They include: 

• Name fields 

• Job title and employer 

• Phone numbers, email address(es) and instant messenger screen names 

• One or more mailing addresses 

• Basic demographics (gender and birthdate) 



Note one small but significant feature of the summary screen. In the screenshot below there 
is a little box with a minus sign in it, next to the "Home (primary location)" text, as well as the 
"Communication Preferences" text. 



H Home (primary location) 
Email: ilemo4clvlcrm.org 



B Communications Preferences 
Privacy: 



Method: 

Email Format Preference; Both 



This '-' (minus) sign icon indicates that the section is 'expanded'. Now take a look at next 
screenshot: 

B Home {primary location) 
Email: damo3Klvicrm.org 

B Communications Preferences 

Now the box contains "+" (plus) sign, and you cannot see the "Communication Preferences" 
fields. This means that the section is "collapsed". Sometimes specific sections will be collapsed 
by default, and you will have to click the "+" sign to see the fields. This happens for example 
when a contact has more than one location entered. The first one is shown by default, the 
rest of them will be collapsed. 

The Summary screen also contains a link to the » Contact Dashboard. This screen allows 
users to view and modify their own group subscriptions, and see the history of their own 
contributions, memberships and event registrations. 

If you're using CiviCRM in conjunction with Drupal or Joomla, you may also see a link to » View 
User Record. This link is shown when the contact is a registered User of your site. It links to 
a CMS-specific User Account screen. 

Name Fields 

Each contact's name can include the following fields: Prefix, First, Middle and Last Names, 
Suffix and Nickname. You don't have to use all of them, but they are available in case you 
want to store all of this information. 

If you wish to record a prefix such as "Mr", "Ms" or "Dr" for your contact you can do so using 
the dropdown box on the edit screen. If there are other prefixes you need to use such as "Sir" 
or "Father", you can add these to the dropdown list in Administer CiviCRM » Option Lists » 
Individual Prefixes (Ms, Mr...). The same applies to name suffixes. 

Locations 



A location is a group of address related fields consisting of phone, email and postal address 
field groups. 

CiviCRM can hold more than one location for a contact. For example, a person may have a 
home address, a billing address and a work address and we need to record these in separate 
locations. One of these locations will be marked as "Primary". It will be used for any postal 
mailings that you do. You can explicitly choose which location will be primary for a particular 
person, or let it default to the first one entered. If a person pays you by credit card the 
details used for credit card payments will be stored in the Billing location for the contact. 
You can specify the maximum number of locations a contact may have from Administer 
CiviCRM » Global Settings » Address Settings. The default for this setting is 1. You will need 
to modify it if you plan on recording multiple addresses for some contacts. 

You can also store multiple phone numbers and email addresses for each location. One of 
these email addresses can be explicitly marked as the address which receives all bulk mailings 
(e.g. emails your organization sends using the CiviMail component). 



RELATIONSHIPS TAB 



Relationships are basically "connections" between contact records in your database. Each such 
connection can be named to describe the nature of the connection. Let's say you have two 
contact records: one for a person - Richard Richardson, and the second one for an 
organization - let's call it ABC Association. Richard is an employee of ABC, and you want to 
store this information in the database. You do this by creating a relationship between Richard 
and his employer. Once you do this, you will be able to see this connection from both Richard's 
and ABC Association's records. Here is Richard's Relationships tab. 



Summary Cont'ibutions Memberships Activities Lvon:s Re.atioisrips Groups 
Change Log First Aid Skills 



Notes 



Tags 



Current Relationships 



Relationship 


Start 


End 


City 5tate/Prov Email Phone 


Employee of A6C 

Association 






View | Edit | Disable I Delete 


Volunteer Conservation 

for Coirp 






Chicago IL View I Edit 1 Disable 1 Delete 


Household Ritiiardson 
Member of Household 






Alameda View | Edit | Disable | Delete 



* Naw Relationship 



Inactive Relationships 

these relationships are Disabled OR have a jsast End Date, 



Relationship 




city state/ Pro v 


Phone 


End Date 




Spouse of 


San, Ann 






January 19m, 2008 


View I Edit | Delete 



Actually, the Employee / Employer relationship is a special one. If you look at the Summary 
tab again you can see that the Current Employer field shows the name "ABC Association". 
This name is actually a link. If you click on it you will go to the "ABC Association" contact 
record. Entering in an Employer in this field is a shortcut way to define an employment 
relationship. Whenever you fill in the Current Employer field a record with a matching name 
will be looked up and the appropriate relationship will be created. If no record for this 
organization exists one will be added before creating the relationship. 

Another special type of relationship is used for connecting individuals with households. Again, 
on the Contact Summary tab you can see the text "Household address" and a link to 
"Richardson Household". This is displayed because instead of filling in Richard's location with 
address information we decided to use his household address. This creates the Household 
Member relationship between Richard and his household. 

Apart from those two special relationship types, you can create and register any other type 
of relationship. The Relationships tab shows all of a contact's existing relationships with 
other contacts (individuals, households or organizations in the database). If you want to create 
a new type of relationship, go to Administer CiviCRM » Option Lists » Relationship Types. 

Additional powerful characteristics of relationships include the ability to set a start and end 
date, or disable them manually if they are not valid anymore. This means, that you can store 
the history of relationships in your contact records. The screenshot below shows a marriage 
that has ended. Other uses include showing children who are no longer considered to have a 
'dependent child' relationship based on reaching their 18th birthday, or changes in employment 
relationships. 

Relationships can be also extended with custom fields if you need to store additional 
information for them. 



ACTIVITIES TAB 



The Activities tab does two things. First, it displays all your interactions with the contact over 
time. This includes all CiviCRM's inbuilt activities like event attendance, contributions, 
membership sign-up and renewal, phone calls, emails and user-defined activities. Second, it 
allows you to record activities with contacts. Clicking on the icons at the top of the screen 
(Send an Email, Meeting, Phone call) will bring up a screen where you can enter those details. 
This tab can also be used to record any custom activities that you've defined for your CiviCRM 
installation from Administer CiviCRM » Option Lists » Activity Types. The ability to define 
custom activity types, and extend them with custom fields provides a powerful tool for 
tracking a wide variety of organization activities. You could choose to track activities such as 
press releases, press conferences, site visits or voluntary work. 

Activities are a great way to store interactions that happen at a specific time, or that link 
specific people. If it is important for you to know who at your organisation carried out a task, 
record it as an activity. Another advantage of activities is that they record when something 
has happened, which is useful if you need to report on the volume of activities performed 
during a specific time period. 

Activities are either set as completed, or scheduled. Scheduled activities that are overdue 
appear in red in the Activities tab. 

_ , . ., 1 1 „ —— —. „,..... 
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Son, Ric 
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Contribution 


$ .03.00 - General 
Membership: 

Offline 
membership 
signup [by 
Jdoe@emall.com) 


son, Ric 


n/a 


ft/a 




completed 


View 


Contribution 


$ 150.00 - 
Beginners Stilts 
Class: Offline 
registration (by 

JdoelSiemall.com) 


Son, Ric 


n/a 


n/a 




Completed 


View 



CONTRIBUTIONS TAB 



The Contribution Tab shows any financial contributions made by the contact whose details you 
are viewing. In the example below, the first contribution was created when a membership fee 
was paid while the second was created when a person signed up for an event. The status is 
set to pending (incomplete transaction) because their payment has yet to be received. When 
the payment is received you can click on 'Edit' to change the status to Completed (you can 
also choose to send an email receipt). 



Summary Contributions Memberships Activities Events Relationships Groups Notes 



Tigs Change Log First Aid Skills 



Contributions received From Ric son since inception. Click Record contribution [Check, Cash, eft ...) to record a new 
contribution received from this contact, Click Submit Credit Card Contribution to process -a new contribution on 
behalf of the contributor using their credit: card. 

» Record Contribution (Cheek, Cwb, EFT ,..) * Submit Credit Card Contribution 



Total Amount ■ $ 150.00 



# Contributions ■ 2 Avg Amount - $ 125.00 



Amount Type Sou rce 



w Received Ibank-you Sent Status 



f 150.00 Event 
Fee 



Beginner? Stilt? 
Class: Offline 
registration (by 

jdfrfi@em4il.e6rn) 



Pending 

(Enc ample be 
"mans action) 



$ tOO .00 Member General 

Due Membership: 
Offline 

membership 
signup {by 

|dwfl)ema,ilLa?m) 



View I Edit I Delete 



view | Edit | Delete 



MEMBERSHIPS TAB 

This tab displays the memberships a contact has signed up for. In this case, the contact signed 
up to be a General member on May 8th, 2009. 



Summary Contributions jMern be nsh i ps: Activities Events Relationships Groups 



Motes Tags Change Log First Aid Skills 

Current and inactive memberships for Ric son are listed below. Click New Membership to record a 
new membership. Click Submit Credit Card Membership to process a Membership on behalf of the 
member using their credit card. 



» New Membership » Submil Credit Card Membership 

Active Memberships 



Membership Start Date 


End Date 


Status Source 


General May sir, 
2009 


May 7th, 

20 LI 


New View | Edit I Renew I Renew-Credlt 
Card | Delete 



EVENTS TAB 

The Events Tab displays event registrations for this contact. Note that the related payment 
showed up on the Contributions Tab (above image) in the top row. 



Summary Contri birtions Memberships Activities Even-.s Relationships Groups Notes Tags 
Change tog First Aid Stills 

This page lists all event registrations tor ftm Sen since inception. Click New Event Registration to register this contact for an 
event. Click Submit Credit Card Event Registration to process a new New Registration on behalf rrf the participant using th-eir 
credit card. 



p New Eveni Refllstraiion a Submit Crad.1 Card Evert Registration 



Fee Level Fee Amount £ Event Date(>>) Register Data(s) -Statu Role 



BeginnEre Performer % ISO-DO 

Stilts Class rat* 'tin 
t'c-ariLicipants' C$150} ■ 1 



May 9th, 2003 May 8th, 2009 Registered Attendee View | Edit | Delete 



GROUPS TAB 



The Groups Tab shows the groups that the contact is a member of. Groups can be used for 
several reasons including mailing lists and permissioning (ACLs). Note that the group that 
displays "Added (by Web)" is the one the contact has added themselves to (e.g. from the 
Contact Dashboard or some other web form). On the other hand, an administrator or staff 
member has added them to the "Case Resources" group. Whether users can add themselves 
to a group is one of the settings configured for a group. When you set a group's visibility to 
"Public Listings" users can join via Profile forms. You may want to familiarise yourself with the 
discussion on using Profiles for mailing list sign-ups covered in a later section. Also note that 
you can see a history of groups the contact has unsubscribed or been removed from. 

Summary Contributions Memberships Activities Events Relationships Groups Notes fags 
Change Log First Aid Skills 
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Added (by Admin; 
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[ Remove ] 



Past Groups 

Rfc Son is no longer part or these group(s}. 



Croup 


Status 


Da t* Added 


Date Rtrnfl-ved 




AdmlniiUator* 


Removed {by Admin) 


Hay -8th r 2604 4:37 M4 


May ath, 2003- 4:37 FM 


[ Rejoin Group ] 


Advisory Board 


Removed {by Admin) 


May 8th r 2003 4:36 S»M 


Hay Bth, 2M9 4:S0PM 


[ Rejoin Group ] 



NOTES TAB 

The Notes Tab is a place where you can record random bits of information about a contact. 
Generally you would use custom fields for information you plan to collect about your contacts, 
but in some cases it may be useful to record additional, ad-hoc notes about people. Since 
information stored in notes is unstructured, you should be careful about using the Notes Tab, 
unless you know that you or other people using your iviCRM implementation will remember to 
look at that tab. When creating a Note both the subject and the content are free-text fields 
(i.e. the subject field does not have to be chosen from pre-defined options). 





Sum/nary Contributions Memberships Activities Events Relat 
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s Groups 




Notes 


Tegs 


Change Log First Aid Skills 
















Note Subject Date Created By 




Rlc seems to be allergic to fish. Verify. Allergy May S'h, 2009 Jdoe@emall.com 


View 


Edit | Delete 


















» New Note 











TAGS TAB 



Tags are one way of categorizing contacts in your database. (Other methods are Custom Data 
and Groups). You can configure which tags you wish to use for your organization. You can 
search on tags and create Smart Groups based on them. 



Summary Contributions Memberships Activities 


Events 


Relationships 


Groups 


Motes Tags Change Log First Ait) Skills 












D Company 








□ Government Entity 








D Major Donor 








D Non-profit 








H volunteer 









CHANGE LOG TAB 



This tab gives limited information about changes made to a contact record. It shows the 
change date and who made the change, but not what was changed. 



Summary Contributions Memberships Activities Events Relationships 



Groups. 



Motes Tags Change Log: First Aid Skills 
Change Log: Rlc Son 



Changed By 


Change Pate 




6 idce@emBi.com 


May 8th, 2009 5:07 PM 




ft shot@dvicrm.org 


May BtH, 2003 5;06 PM 




ft shotfelvlcrm.org 


May 8th, 2009 5:05 PM 




ft jdoe@email.oorn 


May 8th, 2009 4-58 PM 




& jdoeOemaii.com 


May 8th, 2009 2:59 PM 





THE 'FIRST AID SKILLS' TAB 

Many organizations need more information than is provided in the standard contact fields. You 
can define additional custom fields that are relevant to your organisation such as marital 
status, education or first aid skills. You can read up elsewhere on how and when to create 
custom fields but right now we would like to draw your attention to how they appear in a 
contact's screen. If you are looking at an installation of CiviCRM and you see unfamiliar tabs 
then chances are they have been created by custom fields. 

In the screenshot below case we have created a group of custom fields called "First Aid Skills". 
When creating the custom data group we selected "Tab" as the display style. This caused the 
fields to show in a separate tab. If we had selected the other option, "Inline", the fields would 
have shown up as one of the field groups on the Contact Summary tab. 



Motes Tags Change Log First Aid Skills 



Summary Contributions Memberships Activities Events Relationships Groups 



» Edil First AJd Skills 

B First Aid Skills x] 

First Aid refresher 
course required 



Yes 



CONTROLLING THE CONTACT SCREENS 



After working with the contact editing and summary screens for a while, you may realise that 
there are sections and / or fields that aren't useful for your organization. The good news is 
that you can easily hide some fields and sections. For example, if your organisation doesn't 
need to store demographics information - you can remove it by configuring Site Preferences: 

• Login to CiviCRM using account with Administer CiviCRM privileges, 

• Navigate to Administer CiviCRM » Global Settings » Site Preferences, 

• Un-check the Demographics box under Editing Contacts, 

• Hit Save button. 

Similarly, if you want to remove (or add) fields in the postal address section: 

• Navigate to Administer CiviCRM » Global Settings » Address Settings 

• Check or un-check fields under Address Editing 

• Hit Save button. 
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MANAGING CONTACTS 



There are several ways contacts get added to your database. You might add them one at a 
time, they might add themselves through your website, or you might import them in bulk 
using CiviCRM's import functionality. 

ADDING CONTACTS 

First decide whether your contact is an individual, a household, or an organisation, and then 
click on the New Individual/Organisation/Household from the CiviCRM home page. 

You will be redirected to the contact add form where you can add personal and contact 
details. You can enter one or more postal addresses, phone numbers and email addresses. 
Contact details are identified by location. For example, you may want to record a 
constituents home phone, mobile phone and work phone. Click "another phone" to see 
additional phone fields within each Location. 

TIP: Preferred phone numbers and email addresses should appear first and are marked 
"Preferred". 

TIP: Only the location marked primary will be displayed in search results. 
Other ways to add contacts 

• Via the Quick Add Block - For Joomla users, this always appears in the left sidebar 
when within CiviCRM. If you are using Drupal and don't see the Quick Add block, you 
may need to enable it in your Drupal blocks menu. To configure your Drupal blocks go to 
Administer » Site Building » Blocks. You must fill in at least a First Name and Last 
Name, or an Email address. If the system detects a potential match based on the 
Matching Rules it will alert you to this fact at this point. This is covered in more depth 
later in this chapter. 

• Via a profile - you can set up a profile as a data entry portal (read on to learn how to 
use CiviCRM profiles). This might be useful if you want to display a simplified data entry 
screen to some staff, or allow members of the public to add data. 

• Via event registration, membership or contributions - when someone interacts with 
your database through your website. When someone registers for an event, for 
example, CiviCRM checks to see if they are already on your database using a duplicate 
matching rule. If no duplicate is found CiviCRM will create a contact record associated 
with that interaction. 

• By importing them - bringing contact information from an external spreadsheet or 
database into CiviCRM. 

PREPARING TO IMPORT DATA 

Importing data is a reasonably involved process and it pays to be familiar with the concepts 
before you start your first import. You can import both core and custom data for contacts as 
well as data for event attendances, activities, memberships and contributions. This chapter 
will focus solely on the import process for contacts. 

There are two ways in which data can be imported: 

• From CSV (comma separated value) files. Each column in your CSV file will map to a 
field in CiviCRM so make sure you use a different column for every bit of information. 
Most database and spreadsheet applications can create and manipulate CSV files. 

• From another database held on the same server by use of an SQL statement. 



Warning: If you do not have a clear understanding of your existing data and how it will map to 
CiviCRM fields, you will experience frustrations and problems when you try to import the data. 
Please read other sections of the CiviCRM Manual and visit the CiviCRM online documentation 
for more information: http://wiki,dvicrm.org/confluence/display/CRMDOC/lmporting+Data 

You may well encounter problems when running the import because every imported data has 
its own quirks. But you can help cut down on problems by following these recommendations: 

Import tips 

• You can add all imported contacts to a new or existing group or tag. Adding contacts to 
a new tag enables you to easily identify when a contact was imported and undo an 
import if necessary. Tagging and grouping contacts is quite limited during import. You 
can only assign a contact to one particular group or tag. One way to get around this is 
to create custom data fields representing the data you want to create and then 
converting that custom data to groups after the import using Advanced Search and 
selecting Add to Group from the more actions menu. 

• If your imports are timing out or taking too long, try splitting up imports into smaller 
parts. 

• CiviCRM stores first names and last names in separate fields so these should appear as 
separate columns in your CSV file. The same goes for city and postal code / zip 

code. There are tools for common spreadsheet programmes that automate the process 
of splitting names across fields. Google for "Split text among columns by using 
functions." 

• Do as much data cleansing as possible prior to the import. That is, make sure data has 
the right type, is represented consistently (is a state shown as California or CA?), and 
contains no unnecessary fields 

• Always test your data import with a small subset of your records. After importing the 
test set, visit the records within CiviCRM and ensure that the data was imported and 
functions as you expected 

• Consider creating a dummy contact that has every attribute you've defined in your 
existing data set. Then import the contact and check results to ensure that CiviCRM 
correctly represents all the data labels and options in your old data 

• If the import you are doing is one that you are likely to want to use again for a different 
import file, CiviCRM allows you to save the the import maps (i.e which field in the csv 
file should go into which CiviCRM field). You will be required to give it a name. Just use 
something that makes it obvious (to you) what the particular mapping is for. 

• If you are importing multi-choice options (e.g. checkbox or radio etc.) with custom data, 
you can use either the label or the value of the field the import will accept both the 
Label and the Value. With core data you can only use label, and not value. 

• If you are updating multiple choice options, new values will replace the entire field - not 
just add values that aren't there, for example, if you update colors to be 'orange', for a 
contact that currently has colors set to blue, the result will be that colors are set to 
orange, not orange and blue. 

• If you are importing multiple locations, the first location will be set as the primary 
location. You may want to move your columns around to ensure the desired Location 
becomes the Primary. You may also need to split your import so that some records 
have one type of record as their Primary, while others have a different one. 

• Ensure that your country names are expressed in the same way as they are in CiviCRM, 
i.e. 'United States', not 'United States of America', and 'United Kingdom', not 'England'. 

• Make sure you are using an accepted date format (e.g. DD/MM/YY is not accepted but 
DD/MM/YYYY is) 

• Make sure any name prefixes and suffixes you use have been set up in the 
administration interface (Administer » Option Lists). 

RUNNING AN IMPORT 

The import process has five steps. 
STEP 1: SET UP 



Set up lets you specify some basic details of your import including the source of the data. 
Data can either come from a CSV file, or from an SQL query of a database on your server. 

Import uses the default strict rule to decide whether a contact record is a duplicate. You can 
specify what action to take when import encounters a duplicate. 

• Skip the duplicate contact, i.e. leave the original record as it is. 

• Update the original record with the database fields from the import data. Fields that 
are not included in the import data will be left as they are. 

• Fill in the additional contact data only and leave fields which currently have values as 
they are. 

• No Duplicate Checking, i.e. inserts all valid records without comparing them to existing 
contact records for possible duplicates. 

Import mappings are the way in which you tell CiviCRM how the fields of data in your import 
file correspond to the fields in CiviCRM. If you have a pre-existing field mapping, you can load 
it here. 

TIP: if you have a saved mapping, and want to use it, but have a table to import that has 
some new columns added, then by moving those columns to the end of your spreadsheet, you 
can reuse the Saved Mapping and simply map the new fields in at the bottom. 

STEP 2: MATCH THE FIELDS 

In this step you select the matching CiviCRM database fields from the drop-down lists in the 
right-hand column. Select '- do not import -' for any columns in the import file that you want 
ignored. 

If you think you may be importing additional data from the same data source, check 'Save this 
field mapping' at the bottom of the page before continuing. The saved mapping can then be 
easily reused the next time data is imported. 

STEP 3: PREVIEW 

This screen summarises the import that is about to take place and reports back on invalid 
data or formatting errors. If you continue, the affected records will be skipped, or you can 
download a file with just these problem records, correct them in the original import file, cancel 
this import and begin again at step 1. 

At this stage of the Import you have the option to add the imported contacts to a new or 
existing Group or Tag. Even if you do not need to do this as part of your outcome, it is worth 
using this in order to be able to quickly find the imports and if necessary delete and reimport 
if required. 

STEP 4: SUMMARY 

The final screen reports on the successful imports, and provides you with reports for Duplicate 
Contacts and Errors. If you have set the import to add all contacts to a Group or Tag, you 
can click through to see your imported contact records. 

DEDUPING AND MERGING 

Duplicates can appear in your data for many reasons including mistakes by members of your 
staff. They can also be created when people fill in forms about themselves on your site (e.g. 
event registrations). CiviCRM has 'duplicate matching rules' to minimise the chance of this 
happening but there are still cases when some human intelligence needs to be applied to 
decide if two entries are the same person or not. F When duplicates do occur, CiviCRM 
provides a set of tools for finding and merging duplicate contacts. These are accessed through 
the admin interface (Administer CiviCRM » Find and Merge Duplicate Contacts). 

You can set up different rules for identifying suspected duplicates. When you use these rules 
(by clicking on 'use rule'), suspected duplicates are shown side by side in a table. 



Editing Rules 

You can configure up to five fields to evaluate when searching for 'suspected' duplicate contact 
records of a particular contact type. For each field, set a numeric weight which determines the 
relative importance of a match on that field. 

You can also set a length value which determines how many characters in the field should be 
compared. 

EXAMPLE: If you set a length of 2 on 'First name', then 'Mike' would match 'Michael', because 
the first 2 characters are the same. If length is left blank, then the comparison is done on the 
entire field value. 

Finally, you set a numerical threshold for the rule. When the total of the weights of each 
match is equal to or greater than this threshold - the contacts will be listed as suspected 
duplicates by the Find and Merge Duplicate Contacts task. 

EXAMPLE: A match based on First = 2, Last = 8, Cell=10 and Threshold 

In the example below, the match has been set to first three characters for First and Last 
name. This will therefore spot potential duplicates such as Pete Davies and Peter Davis. 
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The rule will then return any contacts whose results meet the threshold. 



Contact 2 (Duplicate) 



Peter Davis 



Peter Davies 



22 



merge 



Clicking on merge for any pair of contacts brings up a table showing both sets of details. For 
each detail you can choose whether to keep the original data (shown on the right) or copy the 
duplicate data. 



;*fTtip between original and duplicate contac 






Peter Davies (duplicate) Mark All 






Birth Date 


January 2nd, 


19M 


= =!*==> 




Last Name 


Davies 




— D--> 


Davis 


Location 
Home:en\ail 


peter, davi s@a 1 p ha beta . com 


==D==> 


' Home 14^ (overwrite) 

peter.dsvis Sialphabe ta .com 


Location 

Home:phone 


Q1234567B9 




==e=« 


' Home • i\ (add) 


Location 
Home:address 






— B--> 


f Home ^(overwrite) 
1 Alpha Street Wellington, 


Move 


"Fags 




==S_> 


Tags 



If you realise you want to move the information in the opposite direction, there is an option to 
"Flip between original and duplicate contacts" which will swop the two sets of results over, so 
can move data from A to B, rather than B to A. 

Note associated tags, groups and activity data (including event attendance, contributions, etc.) 
will appear in addition to data already recorded in the original record, not in place of it. 

Please note, you can restrict the search to particular Groups, this is a good option with large 
datasets to reduce the time each search will take. To do this, make some Smart Groups 
based on a section of the alphabet eg a group of all surnames beginning with A-D. 

Strict rules vs Fuzzy rules 

There are two categories of dedupe rules - 'Strict' and 'Fuzzy'. 'Strict' rules should be 
configured with a relatively tight definition of what constitutes a match (for example... email 
address + first and last name for Individuals). It is more important with Strict rules that you 
avoid false matches than that you catch every possible duplicate as it is easier to sort out 
duplicates later on than it is to disentangle two incorrectly merged contacts. The default 
'Strict' rule is automatically used when new contacts are created via the frontend of your 
website (including contacts created by constituents during online contributions, etc.). They are 
also used when you import contacts. You can only have one default 'Strict' rule for each 
contact type. 

'Fuzzy' rules should be configured with a looser definition of what constitutes a 'match'. They 
pick up a wider range of possible matches because they are used in instances where human 
intelligence can be applied to decide if they are a match. The default Fuzzy rule is 
automatically used to check for possible duplicates when contacts are added or edited via the 
user interface. You'll also want to use a Fuzzy rule when scanning your database periodically 
for possible duplicates. Click Use Rule to scan for duplicate contacts (of that contact type) 
using the selected rule. 
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GROUPS 



Groups are an incredibly important feature within CiviCRM. They play a critical role in CiviMail 
and Profiles as well as their fundamental use as collections of contacts that have something in 
common. Whenever you hear about the concept "contact database segmentation", groups will 
be one of the most important tools that you'll use for it. 

There are two kinds of Groups - Regular Groups and Smart Groups. 

Regular Groups allow you to explicitly place contacts in a group independent of their 
characteristics, based on your personal decision. For example, you would need to manually 
assign your Board Members to a "Board of Directors" group. You can then use this group to 
easily send board-related emails to each person who is a member. You may also want to 
restrict permissions to view and/or edit the contacts in this group. 

Smart Groups allow you to configure them in such a way that contacts are automatically 
assigned to them based on one or more characteristics and/or activities of those contacts. For 
example, you can create a Smart Group for "Recent Contributors from California" - which 
combines the "activity" of making a contribution during the current year and the 
"characteristic" of having an address in California. When new contacts located in California 
make a contribution, they are automatically added to this group. 

BASIC SETTINGS AND FUNCTIONALITY 

As mentioned earlier, groups in CiviCRM can perform many different functions. Not every 
group needs to be used for every function though. Every group has specific set of settings 
which describe what it can be used for and what it can't: 

Group- Settings 

You can edit the Name and Description for this group here. Click Show Group Members to view, add or 
remove contacts In this group. 



Name * Board Memo ere 



Description Contacts In this group are aelong to The Board. It's >oth Access Co-trol 
and Mailing List type of group. 



firojp dpsc ripticin is displayed wfpn groi.ps a r fl listed i" profiles and Maili"g I sir Subsc.HbP forms. 
Group Type g Aocess control Snailino. List Q 

vl,ibl,lt V* | user and User Admin Only ^ Q 

Parent Groups 



:' 



» Show Group Members 



Name and Description: it's a good practice to always use very clear group names and fill in 
the group description with additional details. When you will be working with the given group in 
a different context (for example in CiviMail), you will be able to quickly figure out what it is 
for. Also, it is very easy for an organisation to quickly amass dozens of groups so the more 
clear the name and purpose the better. 



Group type 



There are two general uses for groups: 

• Access Control (Drupal only) is used to assign access permissions to a set of contacts. 
A group can also be a target of the permissions. The group 'secretaries', for example, 
might have access to view the details of the group 'managers'. This use of groups is only 
able to be used for Regular Groups. 

• Mailing List is used if you want to send out CiviMail mailings to members of this group 
(more on this below). This setting is available for both Regular and Smart Groups. 

Visibility 

Visibility indicates who will be able to view this group. Select 'User and User Admin Only' if 
membership in this group is controlled by authorised CiviCRM users only (people/staff who are 
allowed to log into the database). If you want to allow contacts to join and remove themselves 
from this group via your website using profiles (more on this below) you should always select 
'Public User Pages.' If you also want to allow the group to be searched via a Profile used as a 
directory, select 'Public User Pages and Listings'. 

Hierarchical or Nested Groups 

Some organisations find it useful to create a hierarchy of groups. In CiviCRM, this is done by 
creating a "Parent" group and then assigning other "sub-groups" under them. When a user 
sends a mailing to a "Parent", or searches for contacts in a "Parent" group - all contacts in the 
associated child groups are automatically included. 

EXAMPLE: An organisation that has a National office and 5 regional offices wants all 5 regional 
offices to be associated with the National Office. To accomplish this, they create a "National" 
group and then assign it as the "Parent" for all regional groups. The National office can now 
send mailings (for example) to the "National" group - knowing that all members of the regional 
groups will be included. 

Adding contacts to Groups 

Individual contacts can be added to a Group either in the Contact edit screen or via the 
Groups Tab. Multiple contacts can be added to a group at once by conducting a search, and 
then selecting Add Contacts to a Group using the More Actions menu. The second way allows 
you to add multiple contacts to a group by going to Manage Groups, selecting Members for the 
relevant Group and then using the Add Members to this Group option at the top of the 
screen. 

Contacts can also be added to a Group as a result of filling out a Profile (see below). 

Managing Groups 

All Groups can be found via the Manage Groups link in the CiviCRM menu block. You can search 
for Groups by name, Type (i.e. use), Visibility, and whether or not the Group is Enabled. 

Find Groups 
Find 



□ Access Control Q Mailing List [- any visibility - I % ^Enabled □ DIs 

Compare OR partial group name. Filler search by group rype(s). 

I User and User Admin Only 



( Search ) [public User Pages 

Public User Pages and Ustinqs 



SMART GROUPS 

Since Smart Groups are essentially saved searches, they are a powerful tool to standardise 
your organisational processes. For example, you can create a Smart Group of all donors who 
have not yet been sent a thank-you letter. As you send your letters, the donors receiving 
them will automatically leave the smart group, allowing you to always have an accurate list to 
work from. 



Whilst the principle of a Smart Group is that it is a 'saved search', specific individuals can be 
added or removed from them. For example, if someone unsubscribes from a mailing that is 
based on a Smart Group, they will be recorded as "Removed from the group" even if they still 
meet that smart group's search criteria. Similarly, you can manually add a specific individual to 
a Smart Group. For example, someone who has left a town but still wants to receive the 
newsletter that goes out to the Smart Group of everyone in the town, can be manually added 
to the smart group. 

You can search for group members based on their status (e.g. Added or Removed) by going to 
Manage Groups » Group X » Members » Find Members within this Group, and then 
select one or several of the Added, Removed, or Pending status checkboxes. 

Find Members within this Group 



Name a r Email | l«... -any contact type - v| Group SUttif 

Added □ Removed □pending 



Modifying Smart Group Criteria 

When you need to modify the criteria of an existing smart group follow these steps: 

1. Go to Manage Groups » Smart Group X » Members to find everyone in that smart 
group. 

2. At the top of the results page for this search, you'll see a link called » Edit Smart 
Group Search Criteria for Smart Group X 

3. Edit the criteria and then run the search again. 

4. Then select Update Smart Group from the 'more actions' menu on the search results 
page. 

This will update the members in the group and from then on new members will be added 
based on the revised criteria. 

GROUPS AND CIVIMAIL 

Groups are the foundation of CiviMail. CiviMail uses groups (regular or smart) to determine the 
recipients of a mailing. You can include groups in your CiviMail mailing as well as exclude 
them. There is also a function to send emails to a selection of individuals without adding them 
to a Group first, which you may want to do if you have a one-time need to communicate to a 
large set of contacts. This function (Search » More Actions » Schedule/Send a mass 
mailing) however, still requires a Base Group for the mailing to go to. For this reason, and 
because it is useful to have a small test group that all CiviMails are sent to, we recommend 
setting up a 'test mail' group, and then using this as your Base Group. 

If you want to allow contacts to add themselves directly to a group, CiviMail provides an easy 
way for them to do that by providing a preset URL that can be used. You can include this URL 
in an email that you send to a group of contacts if they click on it they will go to a page that 
displays any Groups that have the following characteristics 

• Group Type = Mailing List 

• Visibility = Public User Pages or Public User Pages and Listings 

The URL for subscribing to Newsletters is: 
http://www.myorganisation.org/civicrm/mailing/subscribe?reset=1 

You can also have a page that lists just a single Group for signing up to by adding gid=XX 
where XX is the ID of the Group to the URL, e.g. if the Group ID is 1, the URL would be: 
http://www.myorganization.org/civicrm/mailing/subscribe?reset=1&gid=1 

A confirmation request will be sent via email to the subscriber for each selected email list 
asking them to activate their subscription to each list by responding to the corresponding 
confirmation email. 



TIP: For Drupal users, be sure to grant the "access CiviMail subscribe/unsubscribe pages" for 
anonymous users if using this feature. 

SEARCHING AND GROUPS 

When using Advanced Search, if you select several Groups in the Group box near the top, it 
will treat the search as an OR search, and return results for contacts who are in any of the 
Groups you select. If you want to find people who are in ALL of the groups, you will need to 
use "Search Builder". 

There is also a very useful built in Custom Search that enables you to find contacts who are in 
one Group but not in another (CiviCRM » Find Contacts »Custom Searches). 
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TIP: An alternative route to finding all the contacts who are not in a particular Group e.g. 
Group A, is to create a Group B that contains aj[ contacts, then find Group A via Advanced 
Search and use More Actions to remove them from Group B, which gives you the grouping you 
were wanting. 

GROUPS AND PROFILES 

For this section, you have to have a basic grasp of what CiviCRM Profiles are and how they 
work. 

Groups play two special roles in relation to Profiles. Both of them are to be found in a Profile's 
Advanced Settings. 

Advanced Settings 



Limit listings to a specific 

Group? l - 

Add new contacts to a Group? '~ 



select - 



select ■ 



If you are using a profile to provide a 'search and listing' option (e.g. directory), then you 
can restrict the directory to list only those contacts who belong to a certain Group. A 
common usage of this is to limit the contacts in your directory to only the paid up 
members of an association. 

The second usage is applicable when using a profile as a signup form. You are able to 
directly add all the contacts who fill out the profile form to a particular group. For 
example, if you have a profile form asking contacts to offer their services as a 
Volunteer, then all those who fill out the form can be automatically be added to a 
Volunteer Group. 



GROUPS AND ACL (DRUPAL ONLY) 



Access Control Lists (ACL) provide finer grained permissioning than what is available through 
Drupal's Permissions and Roles. Setting up ACLs requires a good understanding of the concept, 
which is thoroughly explained in the online CiviCRM Documentation here: 
http://wiki.civicrm,org/confluence/display/CRMDOC/Access+Control 

As with many processes, the key is to make sure you have assembled all the parts before 
you try to join them together. In this case you must set up the required Groups, Custom 
Data Groups, Profiles and Roles before you can use them in ACL. 

GROUPS AND ORGANIC GROUPS (DRUPAL ONLY) 

Drupal users of CiviCRM have additional options when it comes to using Groups. The Organic 
Groups CiviCRM module http://drupal.org/project/og_civicrm integrates organic groups, like 
google groups for example, with CiviCRM groups. This is useful for groups that form organically 
on your website but need to be tracked within your organization. Once the group of web users 
are in CiviCRM they can be used for mailings, tracking address information, tracking activities 
or anything else you might do with your CiviCRM contacts. 

Once the Organic Groups CiviCRM module is enabled via Drupal Administer » Site Building 
» Modules - it automatically creates two CiviCRM groups for each existing Drupal Organic 
Group: 

• A "normal" group containing a contact record for each corresponding Organic Group user 
member. This group is assigned the same name as the linked Organic Group. (The linking 
is by convention - e.g. the fact that they have the same name IS the link.) 

• An "ACL" group containing the contact record of the "administrator" of the 
corresponding Organic Group. This gives the OG group admin the ability to view and edit 
members of "their" group in CiviCRM. 

The groups are synchronized "one-way" - from Organic Groups to CiviCRM Groups. When a 
new user is added / signs up for an Organic Group, they are automatically added to the 
corresponding CiviCRM Group. If they leave the OG then they are removed from the CiviCRM 
Group. If an organic group is deleted the CiviCRM group is deleted. 
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COLLECTING AND SHARING DATA 



CiviCRM provides powerful tools for collecting information from your constituents as well as 
sharing it through your website. These features can save you significant staff time because 
you can allow people to update their own data and you can display the latest information from 
your database in a variety of ways. 

For example, a membership-based organization can provide a searchable membership 
directory on their website that is updated as soon as a new member joins the organization. 
Another example is a form where people can sign up to receive emails from your organization. 
Once submitted, they are added to the correct email list automatically. 

This section will cover the techniques you can use for both collecting and sharing data. 

PROFILES: AN OVERVIEW 

Profiles provide an extremely flexible set of options which allow you to create forms, 
directories, and much more. You can think of a Profile as providing a window into your data. 
Just like you can have many windows in a house where you get views of different objects in 
the house, you can have multiple profiles which refer to some of the same fields. 

There are many ways that profiles are used: 

• Forms: a profile can be used as a form to collect information from your contacts. You 
can also add profiles to contribution, membership signup, and event registration pages to 
collect additional information from donors, members, and event participants. Lastly, you 
can use profile forms as simplified data entry screens. 

• View/Edit User Account (Drupal Only): Many times it is useful to allow your 
constituents to manage their own data through your website. This use of profiles 
involves allowing people to edit their information when they are managing their Drupal 
account. When they do so, this information is automatically updated in CiviCRM. 

• Website User Registration: This use allows you to include a set of fields in the New 
Account registration form (Drupal) or create a profile that includes website user 
registration fields (Joomla!). 

• Directory. A profile can be used to create a searchable directory that allows visitors to 
view and use your site. 

• Search Results: Using profiles allows you to display the fields you require in the results 
of a CiviCRM Advanced Search 

• Mass Data Updates (batch updates): It is a common need to update a large number of 
records all at once. Profiles allow you to do that too. 

Another important point about profiles is that some profiles can be used in multiple ways. 

COLLECTING DATA FROM CONSTITUENTS 

This section will review the different methods in which you can use profiles to collect 
information from your constituents. A later section will discuss how to share information from 
CiviCRM with your constituents. 

A volunteer sign-up form 

Let's walk through an example of a profile used as a volunteer sign-up form. This simple form 
includes fields for First Name, Last Name, and Mailing Address. It also includes a reCAPTCHA 
widget to protect from automated abuse (described further below). 



Signup 

First Name * 

tail ff.tnn; * 
5tr«*t Addrtti 



Portal Code 



co""«n* [ united Bawl 

State / Province . select - 
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Typq lri*lwg wpr4#: 
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To build a a form similar to this one: 



1. Go to Administer CiviCRM » CiviCRM Profile and click on "New CiviCRM Profile" 

2. Mark it to be Used For a "Profile": 



Profile Name • volunteer Signup 

used For Q f3 Profile D Search Results O User Registration D View/Edit User Account 

3. The next two text fields allow you to provide help text to assist the person filling out 
the form. 





Profile Example 






This is where trie Pre-form help appears 
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Last 












This is the 'Field Help 1 for the 'Last Name' Field - and has the html code for a 
'horizontal rule 1 added to the end to help separate this from the next section of fields 












City 

















This is where the Post-form help appears 



4. The remaining options are listed under "Advanced Settings" (you will need to click on the 
gray bar to expand this section): 



Add new contacts to a group. It is sometimes useful to add people directly to a 
group upon submitting a profile form. For example, you can automatically add the 
people that fill out this volunteer signup form to your pre-existing "Volunteers" 
group. You will need to create the group you would like to automatically add 
contacts to BEFORE building your profile. 





Advanced Settings 


Limit listings to a specific 
Group? 






- select - 


- a 






1 Add new contacts to a Group 5 




s 


- selprr - 


- u 




S 



Notify when profile form is submitted? Who in your organization should receive 
an email when someone fills out the form? Enter their email address here. 
Redirect URL. When someone clicks save to submit the form, do you want to 
take them to a specific URL? Most commonly, you would create a special Thank- 
You page on your website to redirect people to. (This setting does not apply if you 
embed your form in an event signup or contribution form) 

Cancel Redirect URL. Similar to the previous item, what is the URL you want to 
redirect people to if they click to cancel the form. (This setting does not apply if 
you embed your form in an event signup or contribution form) 
Include reCAPTCHA. CAPTCHA is a type of spam blocking software that requires 
the visitor to fill in text generated from a graphic. In so doing, it prohibits 
automated spiders from completing the form. It is highly recommended that you 
include it. You must have configured your free reCAPTCHA account before enabling 
this. Go to Administer CiviCRM » Global Settings » Miscellaneous Settings to 
configure this. 



□ Include reCAPTCHA? Q 



6. Update Contact on a duplicate match. This is a very important setting. If the 
person filling out the form already exists in CiviCRM, then with this setting enabled, 
their record will be updated if a match is found. This is generally the desired 
behavior so it is recommended that you enable this option. Contact matching is 
done using the default Strict Contact Matching Rule. You may want to familiarize 
yourself with CiviCRM's Contact Matching process before inviting visitors to fill in 
your profile forms. 

Once you have saved the profile settings, it's time to add fields to the profile. If you plan to 
reference custom fields in a profile form, make sure that the fields have already been created. 

A few other important notes on adding fields for this example: 



1. You can change the name of a field label for the profile. For example, the Postal Code 
field can be renamed Zip Code if your audience is more used to that term. 

2. You can make certain fields required. In this scenario, we would want to at least make 
First Name and Last Name required. 

3. You can make a field View only. This setting is not relevant for the volunteer sign-up 
scenario. 

4. Since this profile form will be used on your website, you need to make sure all of your 
fields' visibility settings are set to "Public User Pages." 

[ Save ] [ Save and New | [ Cancel ] 



Field Name Individual v First Name 



Select the type ofCiviCRM record and the field you want to include in this Profile, 



Field Label First Name 



The field label displayed on the form (over-ride the default field label here, if desired). 

Required? [~ J 

Are users required to complete this field? 
View Only? fj 

If checked, users can view but not edit this field. 



Visibility * | Public User Pages 



Important 

For our volunteer signup form, you cannot include Event, Participant or Membership fields. 
Profiles that are directly displayed to contacts through a form, search, or listing view must use 
all the same contact type fields. You may only include event, participant, membership and 
other fields if the profile will be used for an event page or contribution page. 

You also cannot mix fields which belong to different types of records. Profiles that are directly 
displayed to website users through a form, search, or listing view must use all the same 
contact type fields. For example, if your profile includes Individual contact fields like first and 
last name, you cannot include fields related to Organizational records such as SIC Code. 

Data Entry Tool 

If you have volunteers or interns that you ask to perform manual data entry for your 
organization, a simplified way to do that is to create a profile form with just shows the fields 
they will need to input. This greatly simplifies data entry and avoids the chance of them 
incorrectly entering data. 

Linking to your Form 

Once your profile signup form is built, it is ready to be used! There are several ways to do 
this. 



• Drupal: Create link(s) to the form using the following path: 
http://www.myorganization.org/civicrm/profile/create?reset=1&gid=N where N is 
the ID of the Profile. (Each Profile has a unique numeric ID - you can find a profile's ID by 
checking the third column of the table at CiviCRM » Administer » CiviCRM Profile) 

• Drupal: Create a link or a menu item for logged in users to edit their information. If 
they are logged in and go to the profile URL, the fields of the profile will be pre-filled and 
they will be able to leave fields as-is or update them accordingly. The URL path here is: 
http://www.myorganization.org/civicrm/profile/edit?reset=1&gid=N where N is the 
ID of the Profile. 

• Joomla!: Use the Menu Manager to create a front-end menu item. After creating a new 
menu item, select CiviCRM and choose the type of profile display you would like to use. 
In the parameters pane, choose the specific profile to use. 

• A great feature is to provide your non-logged in users the ability to view and edit their 
contact information via a profile using CiviMail. To do this, insert the following link with 
appropriate tokens as shown into a CiviMail message: 
http://www.myorganization.org/civicrm/profile/edit? 

reset=1&gid=N&id={contact.contact_id}&{contact.checksum} where N is the ID of 
the Profile form you want them to use for editing. The contact checksum token 
generates a special link that pre-fills the fields of your profile with any information that 
already exists for them in that profile. The special link lasts for 7 days from the day you 
send the mailing. This feature can be used for either Drupal or Joomla! sites. 

• Your final option is to not link directly to the profile at all and simply embed the profile 
form onto any page on your website or ANY website for that matter. On the Profiles 
administration page there is an option called Standalone Form. After clicking it you will 
be taken to a screen where you can copy the raw HTML code and paste it onto any 
page on your site or even any website you want to collect information from. Make sure 
the reCAPTCHA feature is NOT enabled for this profile. reCAPTCHA requires dynamic 
page generation so submitting a stand-alone form with reCAPTCHA enabled will always 
result in an error. 

Important: For Drupal users, be sure you grant anonymous users the following permissions: 
access profile listings and forms, and access custom data (if your profile contains custom 
fields). 

Including Profiles on your Event Registration and Contribution Pages 

Very often you will want to define certain fields for inclusion in event registration and 
contribution pages. This process is similar to the example above. The only significant difference 
is that you can include fields in your profile that are specific to participant records (for event 
registration forms) and contributions (for contribution pages). You should read the sections 
covering creating contribution pages and event registration pages for more information. 

Including Profiles in Drupal's User Registration Screen 

For websites that have logged-in users, you may want to allow people to provide additional 
information as they register for an account on your website. Similarly, as people are filling out 
a Profile form you may want to encourage (or force) constituents to sign up for a user 
account. 

To include a profile form during the user registration process: 

1. When creating a profile select User Registration under Used For: 



Profile Name * Contact Information 



Used For Q D Profile D Search Results H User Registration D View/Edit User Account 

2. Then add the fields you want people to fill out as they register using the same process 
described above. Make sure the field visibility is set to Public User Pages. 

Including Profiles in Drupal's 'My Account' screens 



You can embed one or more CiviCRM profiles directly into Drupal's "My Account" screen. This 
makes it easy for logged in users to review and update this information anytime they visit 
their My Account page. 

To create a Profile for this purpose: 

1. Create a new CiviCRM profile (or navigate to an existing profile and click Settings) 

2. Select "View/Edit User Account" under Used For. 

3. Click Save. 

4. Then add the fields you want people to periodically edit from their account page. 

New Account Creation During Profile Signup 

If you want your constituents to create a Drupal or Joomla! account while filling out your 
profile, you can enable this using the User account registration option under Profile 
Settings » Advanced Settings. Anonymous (not logged in users) will then be invited (or 
required) to create an account when they visit the profile. Logged in users will just see the 
profile fields. 

Drupal user Q ^o account create option w Give option, but not required 

account a . . _ 

u Account creation required Q 
registration ^ ■■ 

option? 

You must include a Primary Email Address field in the profile for this feature to function 
properly. For Drupal sites, this feature also requires the Email Verification option to be 
checked under Drupal Administer » Users » User Settings. There are no additional settings 
required for Joomla! sites. 

SHARING INFORMATION 

Profiles & Directories 

Many organizations have data they would like to display on their website. Historically it has 
been difficult because you would invariably need to manage and update the same data in two 
places — your website and your database. Using CiviCRM profiles solves this problem because 
you can expose data from your database on your website but will only need to manage the 
data in CiviCRM. 

For example, an organization called Native Americans in Philanthropy (NAP) wanted to create a 
membership directory that their members could use to search and connect with other fellow 
members. Before CiviCRM, they would create a very expensive annual print directory and 
mail it to every member. This process was time-consuming and expensive, and it was very 
difficult to keep the data updated. Switching to CiviCRM significantly saved them resources 
and, because their website became a portal for their members to connect, CiviCRM helped to 
advance their mission. 

To get started building your directory: 



1. Go to Administer CiviCRM » CiviCRM Profile and click on New CiviCRM Profile. 

2. Set it to be "Used for" a Profile: 



Profile Name * 



Membership Directory! 



Used For Q ^ Profile □ Search Results 

3. Limit listing to a group. This is very important. By default, CiviCRM will expose every 
record in your database, which is not ideal in most cases. You will want to create a 
smart group of the contacts in your database to appear in the directory. In NAP's case, 
they created a smart group of all members that had a status of New and Current. They 
then limited the directory to only show contacts in that smart group (see below). 
Remember, smart groups are dynamic lists of records. When new contacts join NAP, 
they will display in the directory automatically. 

Limit listings to a specific I . se | ec t . ^1 Q 
Group? ' ' 

4. Advanced Settings. There are a few options under advanced settings that are helpful 
when using profiles for directories. 

1. Enable mapping. A really cool feature available in CiviCRM is to allow visitors to 
map contacts in your directory using Google or Yahoo! maps. They can then obtain 
directions to a record's address dynamically. To enable this you must have already 
enabled mapping under Administer CiviCRM » Mapping and Geocoding 

2. Include profile edit links. Check this box if you want to include a link in the 
directory listings to allow people to edit the profile's fields. Only users with 
permission to edit the contact will see this link. This is not very commonly used in 
the membership directory scenario. More often than not you will not enable this 
setting. 

3. Include Drupal user information (Drupal only). Check this box if you want to 
include a link in the directory listings to view a contacts' Drupal user account 
information (e.g. their 'My Account' page). This link will only be included for 
contacts who have a user account on your website. 

D Enable mapping for this profile? Q 

D Include profile edit links in search results? Q 

D Include Drupal user account information links in search results? Q 

Now it's time to include the fields that will make up the directory. For profiles used as 
directories you have total control over which fields: 

• are searchable in the directory 

• appear in the results columns of your search 

• appear in the record detail "View" page 

As you build your fields to include in your directory, the important options you must configure 
for directory purposes are displayed below: 



Visibility * | Public User Pages and Listings v\ 

Is this field hidden from other users ("User and User Admin C 
Search form ('Public User Pages' or "Public User Pages and Lh 
also click the field value when viewing a contact in order to lo 
live in Poland). 

Searchable? □ 

Do you want to include this field in the Profile's Search form? 
Results Column? 

Is this field included as a column in the search results table? 
User Pages and Listings' visibility. 

• Visibility for all fields in your directory must be set to Public User Pages or Public 
User Pages and Listings. The difference between these two options is that those 
configured as Public user Pages and Listings will have the results in detail view hotlinked, 
enabling the user to generate a follow-up search on that value. For example, you might 
set "City" to Public User Pages and Listings. After the user conducts a search and views 
the details for a record they can click on the city value and run an immediate search. 
The search will run as if they had selected that city in the profile search screen. 

• The Searchable option determines if visitors to your directory can search the directory 
by this field. In common directory uses, almost every field is set to searchable. The 
more fields you set to searchable, the more power you provide to your visitors to find 
the information they need. 

• The Results Column checkbox determines if the the field is displayed as a column in 
the list of results. For example, your directory may have a field for website, and if you 
set the website field to appear in the results column, it will appear in the results table. If 
you do not check the results column the field will still appear in the view mode for a 
record. In other words, checking 'results column' will allow the field to appear in the 
results column AND in detail view mode. 

The search page, the search results page, and a contact view page from our example 
Membership Directory are shown below. 



Membership Directory 



Search Criteria 
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Email 
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Alliance for Good 


New York 


help@alliancegood.org 


http://alliancegood.org 


View 


Edit 
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Floss Manuals 
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info@flossmanuals.net 


http://en.flossmanuals.net 


View 


Edit 
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Save Our Planet 


Seattle 


info@example.org 


http://www.example.org 


View 


Edit 



Membership Directory - Floss Manuals 

Member Name Floss Manuals 

City Berlin 

Email info@flossmanuals.net 

Website http://en.flossmanuals.net 



As we've seen, building a directory for your website can provide a valuable tool for your 
constituents. 

Linking to Your Directory 

To link to your directory you have several options: 

• Drupal: You can send them first to the directory search page using this 

path: http://www.myorganization.org/civicrm/profile?reset=1&gid=N where N is the ID 
of the Profile directory. 

• Drupal: You can send them directly to the listings for your directory using this path: 
http://www.myorgan/'zat/'on.org/civicrm/profile?force=1&gid=N where N is the ID of 
the Profile directory. 

• Joomla!: Use the Menu Manager to create a front-end menu item. After creating a new 
menu item, select CiviCRM and choose the profile search option. In the parameters pane, 
choose the specific profile to use. 

• You can also include search criteria in the URL, or hide the search form completely. 
These options are described here: 
http://wiki.civicrrn.org/confluence/display/CRMDOC/Linking+Profiles 

OTHER PROFILE USES 

Search Results 

Searching is outside the scope of this section but, assuming you are familiar with searches, 
you may wish to change the columns used to display the results of an advanced search. To do 
this: 

1. Select Search Results under Used For. 



Profile Name * Custom Search Results 



Ufed Fnr Q LJ Profile Search Results LU User Registration LJ View/Edit User Account 

2. When adding fields to this profile, you will need to set Visibility for your fields to "Public 
Pages" and mark the "Results Column" box. 

When conducting your Advanced Search, use the "Search Views" dropdown in the top right of 
the page to select your profile. 

Batch Updates 

The final way profiles can be used is to perform batch updates of data. For example, consider 
a scenario in which you have a custom field called "volunteer interests." You conduct a search 
of your volunteers' group because you want to mass update the entire list with a certain 
interest. You can easily update the entire group using a profile. 



1. Select Profile under Used For. 



Profile Name* [update valuntaer interests | 

used For Q SProlile Useareh Results D User Registration D View/Edit User Account 



No other Profile settings are relevant for this type of profile usage. 

2. Add your fields to the profile. Only add fields you need for batch updating. In the above 
example, the only field you would need is your custom "Volunteer Interests" field 
(contact name is always displayed when doing batch update). Remember, fields added to 
the profile must all be of the same contact type. You cannot add fields that are specific 
to both organizations AND individuals. 

Once your profile is created, and you have conducted your search, select Batch Update via 
Profile under -more actions-. Once selected from the menu, you will be asked which profile 
you would like to use. 
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You will then see a grid with the fields in your profile. You can update each field and row 
individually. If there is a field where you want to enter the same value for ALL records, you 
can enter that value in the first row and then click on the "copy values" icon to the left of the 
column header. This will copy the field value to all the rows in your grid. 
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Don't forget to click the Update Contacts button at the bottom of the page to save your 
changes. 

Batch Update Limitations 

• You cannot perform batch updates for different types of contacts (individuals and 
organizations, for example) at the same time. If you wish to update participant fields 
you must do the update from a 'Find Participants' search (and only include participant 
fields in your profile). 

• You may only perform a batch update for 100 records at a time. 



EXPORTING YOUR CONTACTS 

Exporting is a way of sharing your data with external applications by providing a copy of data 
from CiviCRM in a standard format (comma separated value) that can be viewed and edited in 
spreadsheet applications, imported into other database applications, or used to merge with 
word processing applications. You can either export a predefined set of fields or create your 
own custom export mapping which can be saved for reuse. 

The export process has three steps. 

STEP 1: Select contacts you wish to export 

To export contacts, first carry out a search based on your desired criteria using basic or 
advanced search. Then select all records or choose individual records for export using the 
checkboxes to the left of each record. In more actions, choose 'Export Contacts' and hit go, 
which takes you to an export wizard. 
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STEP 2: Export All or Selected Fields 

Choose between exporting the basic primary fields or selecting your own set of fields for 
export. If you want to export custom data, you'll want to choose 'Select fields for export' and 
see step 3. 
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STEP 3: Select Fields to Export 



If you would like to include specific fields or custom fields, choose this option to select the 
fields you want to export. After selecting your fields you will be given the option of saving the 
export mapping, which enables you to reuse the field set at a later time. 
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i/Zi Export All or Selected Fields 



■>3, Select Fields to Export 



Select Fields to Export {step 3 of 3) 

Select the fields to be exported using the table below, For eadh field, first select the contact type that 
the field belongs to te-a. select Individuals if ,ou are exporting. Last Name), Then select the actual 
field to he exported from the drop-down menu which will appear next to the contact type. Your e::port 
can include multiple types of contact records, and non-applicable fields will be empty (e.g, Last Name 
will not be populated for an Organization record). 

Click Select more fields.,, if you want to export more fields than are initially displayed in the table, 

If you want Co use the same export setup in the future, died, "save this field mapping' at the bottom 
of the page before continuing. You will then be able to reload this setup with a single dick, 



Using Field Mapping: Test 2 


Field* to Include In Export Ftle 




Individual | v 1 1 First Name jv| 




Individual |v 1 1 Last Name |v| 




[individual v 1 1 Gentler |v| 




Individual Ml City ! v | I Primary |v| 
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TIP: By default, export uses primary location data. If you wish to export non-primary 
addresses you need to explicitly specify the address type. 

After selecting your desired fields click export and save your file. 

CiviCRM's export functionality is available to you in any of the search tools and when viewing 
group members. This includes component-based search results, where the resulting records 
reflect the component specific data rather than simply core contact data. For example, you 
could export your donors and their contact information for use in a thank you letter in which 
the total amount donated is included. 



By default, a comma is used as the field separator for import and export functions. You may 
change the default value in: Administer CiviCRM » Global Settings » Localization » 
Import/Export Field Separator. 
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SEARCHES 



The whole point of putting information into your CRM system is so you can get information out 
again. Searches are one of the key ways of doing this. They are useful both for retrieving 
specific information and as a form of ad hoc reporting. 

For example, you might do a search because you want to find out the phone number of 
someone in your database. Or you might do a search because you are considering running an 
event targeted at youth, and want to find out how many people in your database are under 18 
years old. 

You can search for different types of information within CiviCRM. Some examples are: 

• People, Organisations or Households 

• Contributions that you have received 

• Grants that you have given out or applied for 

• Events that you are running 

• Mass mailings that you have sent 

Generally the principals of searching are similar for each type of information so we will 
concentrate here on the various ways in which you can search for contacts. 

FINDING CONTACTS 

The main types of search for finding contacts are: 

• The Contact Search box 

• The Find Contacts screen 

• The Advanced Search screen 

• The Search Builder screen 

• Custom searches 

You can also create predefined searches for your users by creating profiles. This method is 
discussed elsewhere. 

THE WILDCARD (%) 

Understanding wildcards really opens up your options when you want to search. In CiviCRM 
when we refer to a wildcard we are talking about the % symbol. You may be familiar with 
other symbols such as '*' from other applications. 

A wildcard is a symbol we use to mean 'any character' (letter or number or punctuation 
mark). It is most easily understood through examples. 

If we search on the first name 'Michael' we will find all the people with the first name 'Michael'. 
If, however, we search on 'Mich%' we might find 'Michelle', 'Michat', 'Micheal' and 'Michele'. This 
is really useful if we don't know how 'Michael's' name is spelled, or we think it might have been 
mispelled. Wildcards can be used before, after or even within words. For example, searching on 
'Mich%el' will exclude 'Michat' and 'Micheal' but still shows 'Michelle', and 'Michael'. 

Contact Search 



mi%el 



Adams, Michael 
Patel, Michelle 
Smith, Michelle 



Go 



You can see that this search is not case sensitive. In other words even though we entered 
'mi%el' in lower case, it found people that had upper case 'M's in their name. 

CONTACT SEARCH 

The contact search is very easy to use and looks like the image above. It uses the format 
'Last name, First name' so if you want to find Michelle Smith you should search for 'Smith, 
Michelle'. You can change how your search behaves but we will assume you have left it at the 
default settings in the next couple of paragraphs. Search settings can be changed under 
CiviCRM » Administer CiviCRM»Global Settings »Settings - Miscellaneous. 

By default the Contact Search has an implicit wildcard. This means that if you enter Mich it 
will treat it as %mich% and find anyone with 'mien' anywhere in their full name. As you type 
you will see possible names presented to you. If you see the one you want you can select it 
and click on 'Go' or press 'Enter' to go into that contact's summary screen. Or you can just 
type in the text you are searching for and click on 'Go' to see all the people who have that 
text in their name. 

If you type in a partial or complete email address, the search box will not offer you any 
options while you type. However, under the default setting, the results screen will show 
contacts with email addresses matching your input. For example, if you type 'gmail.com' and 
click 'Go' your search results will include any contact with a gmail.com email address. 

If you are using Drupal and don't see the Contact Search box while you are on a CiviCRM page 
you may need to enable it in your Drupal blocks menu. You will not see this box on non- 
CiviCRM pages such as your Drupal home page unless you modify the configuration of this 
block (from Administer » Site Building » Blocks). 

FIND CONTACTS 

This simple search form is at CiviCRM > Find Contacts. From this screen you can still enter 
part or all of a name or email address, but you can also narrow down your search by selecting 
a specific type of contact (Individual, Household or Organisation), as well as selecting a specific 
Group and / or Tag. 

The search shown below will find all "Individuals" in the group "Volunteers" who have the 
letters "rich" somewhere in their name or e-mail address. 



Name or Email rich is — Individual * ■" Volunteers 



Once you have your search results, there are many useful things you can do. First click the 
"All records" radio button, or mark the specific rows you want to take action on by clicking the 
checkbox on the left side of each row. Then click the "- more actions -" dropdown as shown in 
the picture below. 
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Add Contacts to Event 
Add Contacts to Group 
Add Contacts to Household 
^Add Contacts to Organization 
Batch Update via Profile 
Delete Contacts 
Export Contacts 
Mailing Labels 
Map Contacts 
New Smart Group 
Record Activity for Contacts 
Remove Contacts from Group 
Schedule/Send a Mass Mailing 
Send Email to Contacts 
Tag Contacts (assign tags) 
Untaq Contacts (remove tags) 
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Some of the most commonly used actions are "Add Contacts to Group", "Export Contacts", 
create and print "Mailing Labels" and "Map Contacts". 

For example, you might want to view the locations of a number of contacts on a map to help 
you plan a route for home visits. To do this, mark the contacts you are interested in and then 
select "Map Contacts". 

This simple search form is quick and useful. However, if you need to search on contact 
attributes other than those offered here (such as address fields or custom data), the 
Advanced Search screen provides many more options. You'll also need to use Advanced 
Search if you want to select contacts in more than one group. 

ADVANCED SEARCH 



Advanced Search allows you to choose from (and combine) a broad range of search criteria, 
and allows you to select more than one option within some criteria. For example, you can use 
Advanced Search to get a list of contacts you have tagged as "Outdoorsy" or "Environmentally 
Aware", who are between 16 and 18 years old, live in "Vancouver", and have a "Student" 
membership. 

In this screen the choices for contact type, groups and tags are shown as checkboxes rather 
than as a dropdown. This allows you to select more than one option. In the case below, your 
search results will include contacts who have been tagged with either "Outdoorsy" OR 
"Volunteer" (or both). If you did not check any tags, then the results would show contacts with 
any tag or indeed those with no tags at all. 



Tag(s) 



LI Major Donor 

I I Non-profit 

SI Outdoorsy 
Volunteer 



You will also see several gray bars on this screen. If you click on a gray bar it expands to 
reveal more options. For example, if you wanted to search for all people in your database 
between 16 and 18 years old you would click on the "Demographics" bar and select the Birth 
Date range you are interested in. 



Demographics 



Birth Dates 



From May -r 08 t 1994 -r II To May -r 08 -r 1996 



Deceased Dates 



From -month- ■» -day- w -year- » I To -month- w -day- » -year- 

Gender 
'.' Female ©Male O Transgender O Test 



Notes 



Change Log 



Contributions 

Pledges 

Memberships 



Events 

If you want to combine this with searching by membership type, you can click on the 
"Memberships" bar. You can continue refining and narrowing your search by selecting or 
entering additional criteria in any of the search panes. For example, if you want to narrow this 
search to contacts living in a specific city, click on the "Address Fields" bar and enter the city 
name. 

If multiple boxes are checked for Contact Types, Groups, Tags and Location Types, the 
selections are combined as OR criteria (e.g. checking 'Group A' and 'Group B' will find contacts 
who are either in 'Group A' OR 'Group B' or both). All other search fields are combined as AND 
criteria (e.g. selecting Tag is 'Major Donor' AND Country is 'Mexico' returns only those contacts 
who meet both criteria). 

Modifying Search Result Columns 

Advanced Searches also allow you to use to change the columns that are displayed in your 
search results. The default columns are Name, Street Address, City, State, Postal Code, 
Country, Email and Phone. If you want to display a different set of columns (perhaps including 
a custom field and removing the Country column) you can create a Profile with the "Search 
Results" option selected. Make sure that the fields in this Profile are set to "Public User Pages 
and Listings" visibility, and are marked as "Results Columns". The Profile will appear in the 
"Search Views" dropdown in the upper right corner of the form - as shown below. 



Search Views : - default view 




- Name and email 
CMS User? '-- , custom Search Results 

Does the conti ,'ity 

Combining this feature with the "Batch Update via Profile" action provides a powerful method 
of viewing and updating a specific set of fields for a batch of contact records. 

You may want to familiarise yourself with the steps for creating Profiles which are described in 
detail in another section. 

Search Builder 

Advanced Search lets you choose from a wide range of criteria but it has one important 
limitation. As noted above, most of the search criteria you select in advanced search are 
combined as AND criteria. For example, if you select a birth date AND select female for 
gender in the "Demographics" section, your results will include only contacts who are born 
after that date AND who are also female. 

The Search Builder tool provides an alternative when you need to do a search using OR for 
some criteria. Continuing the example above, you can build a search for contacts who are born 
within a range of dates OR who are female. 



Include cgnEattE where 



' Individual [Sj &irthi Date 

* Another search field 



m:^_ 



;l 15340101 



Also include contacts where 



' Individual § 'ccmstlwen...; Marital Status 

.Another search field 



1G 



n s 



Search Builder is intended for advanced users and requires you to use specific formats for 
your search values. Refer to the online documentation at 

http://wiki.civicrm.org/confluence/display/CRMDOC/Search+Builder before you try to create 
your own searches. 

CUSTOM SEARCHES 



Custom searches are special searches to meet special needs. The CiviCRM developers 
recognise that some people may need additional ways of collecting and aggregating data, so 
they have created a framework that people can use to create their own searches. When 
properly constructed, custom searches allow users access to the same powerful action options 
that are available from the built-in search screens described earlier. This includes Export, 
Mapping, saving searches as Smart Groups, and more. 

Take a look at the list of available custom searches from CiviCRM > Find Contacts > 
Custom Searches. These have been written by members of the CiviCRM community to meet 
their own needs, and then contributed back to the community. It's worth spending some time 
exploring these searches as some of them may be useful to you, and they give you an idea of 
the sorts of things that are possible. 

The Proximity Search is an excellent example of the power of custom searches: 
Search Criteria 



Tag - any tag 
Street Address 



;' 



City 
Postal Code 



State/ Pro vines - any state/province 



Country * ' united States ^ 

Radius for Proximity Search (m km) 

* 

(search") 



n 



You can use this search to locate contacts within a specific radius of a specific location. 

You need to be comfortable with MySQL and PHP to write your own custom search. If you 
create a custom search that you think would be useful for others, consider contributing it back 
to the community. 

Further reading: 

http://wiki.civicrm.org/confluence/display/CRMDOC/Custom+Search+Cornponents 
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FUNDRAISING PLANNING 



This chapter covers setting up and configuration of fundraising strategies and campaigns with 
CiviCRM. using CiviContribute. CiviContribute allows you to track different types of 
contributions and search and report on contributions. Before reading this, you should have a 
basic knowledge of CiviCRM concepts including custom fields and searching. 

CIVICONTRIBUTE BASICS 

Every contribution you receive can be categorized by type. Examples of contribution types 
include event fees, member dues, donations, and grants. Contribution types are useful 
because: 

• They are a way to organise the income and revenue brought in by your organization, for 
example to differentiate between a foundation grant and the income from in-kind 
donations. 

• They can aid integration with your accounting software by assigning an accounting code 
for each contribution type, which is included when you export contributions for import 
into your accounting package. 

• They help you search your database for contributions. 

First, think about the types of contributions you receive as an organization and which of those 
you want to track using CiviCRM. To configure contribution types, go to Administer CiviCRM 
» Contribution Types. 

CUSTOM DATA 

CiviContribute has a set of pre-defined fields to track contribution information. If you need to 
track more information about contributions, you can define and use custom data fields. 
Custom data might be useful to further categorize your contributions or track additional 
information. 

For example, Healthy Environment Alliance of Utah (HEAL Utah) created a custom field for 
contributions called Contribution Category that lists every fundraising tactic they use 
throughout the year. At the end of the year can quickly compare the success of different 
tactics - a very valuable bit of information for an organization that thrives on community 
support. Below is a screenshot of the options they added to their custom field. 
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First consider all the information you want to track about your contributions and then carefully 
compare it with the pre-defined fields available in CiviCRM. There's no point in creating your 
own custom fields if they already exist and lots of useful functionality is built in to the core 
contribution fields that you can take advantage of if you use them. 



When deciding what data to collect, think carefully about what you need to know, and the 
reports you would like to run on your data. This will help ensure that you don't collect data 
uneccesarily, and that and your data is usable in reports. 

If you don't have CiviCRM installed, you can go look at the core fields on the CiviCRM 
demonstration site http://demo.civicrm.org /. The fields are displayed on a contacts 
contributions tab: click on New Contribution, and review the pre-defined fields. 

If you need to create custom contribution fields you can do so through Administer CiviCRM » 
Custom Data. When creating custom field sets for contributions you can associate them with 
all contribution types or assign them to a specific contribution type. 

REPORTING AND EVALUATION 

When you begin your fundraising efforts with CiviCRM, think about the reports you'll need to 
evaluate how successful you have been. Choose reports that let you see how processes can 
be improved and that can gauge the overall health of your organization. For example: 

• Contribution totals for tactic A versus tactic B 

• Comparing dollar amounts by date range 

• Comparing first-time givers to repeat givers 

• Finding contributors who gave last year but are yet to give this year 

PAYMENT PROCESSORS 

A payment processor is a tool that integrates with CiviCRM to process the live credit card 
transactions. In other words, it accepts the credit card information submitted by your site 
visitor, processes it, and transfers money to your organization's bank account. As of this 
writing, the payment processors compatible with CiviCRM include: 

• PayPal (website standard and pro) 

• Authorize.net 

• Payjunction 

• Google Checkout 

• Moneris eSelect Plus 

• Elavon / Nova 
. eWAY 

• Payjunction 

• PaymentExpress 

• ClickAndPledge 

Each has their own pricing structure and features, benefits and drawbacks. You should 
carefully investigate each available option to determine what is best for you. Important things 
to consider include: 

• Availability in your country and currency 

• Cost (setup costs, monthly cost, transaction fees and commission percentage) 

• Security - whether you want to, and are able to set up your own SSL certificate or 
whether you would prefer a payment processor that captures credit card information on 
its own website. Does the payment provider provide protection against fraud and 
liability? 

• Ability to control branding - does the payment processor take users off your CiviCRM 
site and does this matter to you? 

• Ability to accept recurring payments. Only one or two payment processors are able to 
do this at the time of writing. 

• Ease of use for your customers - does the site visitor need an account with the 
transaction provider in order to process payment? 

• Reputation and reliability. Ask other CiviCRM users about their experiences with 
payment providers. 



Secure Sockets Layer (SSL/HTTPS) 

If you wish to collect credit card information through a CiviCRM form (as opposed to on a 
payment processors own website) you must configure your site for secure sockets layer, or 
SSL encryption. Alternatively you choose to use a processor such as Paypal Standard, Elavon 
or PaymentExpress where the customer is redirected to the payment processor's website to 
enter their credit card details and back to your site afterwards. 

Visitors to your website see that their data is encrypted when the see a symbol (often a 
padlock) somewhere in the browser or by noting that the http: part of your url has been 
replaced by https:.Sinbsp ; 

To enable SSL you will need an SSL certificate. An SSL certificate should be purchased through 
a reputable third party provider, and may range in price from USD$30 - USD$100 a year 
depending on the company and the level of service and protection they provide. 

If you are using shared hosting or a virtual private server (VPS), it is likely that your hosting 
provider has preferred vendors they work with to provide SSL security. Contact your hosting 
provider for more information and to assist with the installation of the SSL certificate. 

SSL certificates are domain-form specific. If purchased and installed to your root domain 
(https://domain.org) , it may not be valid for the www form of your domain 
(https://www.domain.org) . Additionally, subdomains do not automatically inherit the certificate 
authentication (https://sub. domain. org). &nbsp ; Discuss the options available with your hosting 
provider and ensure the certificate and its installation will meet your needs. Wherever 
possible, purchase a certificate that will cover both the root domain and www form of your 
domain. 

Once the certificate is installed and you have tested its functionality by browsing to a page on 
your site using https (rather than http), you should enable SSL redirection in CiviCRM. To do 
this, navigate to: Administer CiviCRM » Global Settings » Resource URLs » Force Secure 
URLs (SSL) » Yes. 

This will force any pages that include contribution related information (i.e. credit card fields) to 
redirect to the secure form of the url (https). 

After enabling the Force Secure URLs setting and saving the page, CiviCRM will automatically 
check to ensure the SSL certificate is activated and working properly. You should also 
navigate to a contribution page on your website to confirm the https redirection works 
correctly. 

PCI DSS Compliance 

The prevalence and impact of online fraud has led to increased security measures to 
counteract the schemes of fraudsters. The Payment Card Industry Data Security Standard 
sets out security standards that all major credit cards require sites to comply with. In cases 
where your CiviCRM page accepts card numbers rather than having your payment processor 
pages accept them, your site and its hosting environment may need to comply with those 
standards. Some payment processors, notably Moneris, put some of the compliance burden on 
you by making you complete a long and technical Self-Assessment Questionnaire. 

For more information, visit: https://www.pcisecuritystandards.org/ 
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MANAGEMENT METHODS 



This chapter discusses methods for fundraising using CiviCRM and its powerful contribution 
management component, CiviContribute. Throughout CiviCRM the term "contribution" is used 
to refer to any financial transaction or payment taking place in the system. This may include a 
donation, event fee payment, membership dues payment, or other similar transaction. This 
chapter assumes you have a working understanding of custom fields, contact matching 
rules, CiviCRM profiles, and the CiviMember and CiviMail components. The chapter also 
assumes you have already set up your payment processor, configured contribution types, 
and created any custom fields you want to use when tracking contributions. 

ONLINE FUNDRAISING 

One of the best parts of CiviCRM is its integration with your site's content management 
system. Once integrated with either Drupal or Joomlal, CiviCRM allows you to build an 
unlimited number of contribution pages that can be seamlessly accessed from your website. 
Contribution pages can be used to: 

• Accept donations and other contributions 

• Process membership signups and renewals 

• Run a specific fundraising campaign 

This section will walk through each of those three scenarios and point out some options and 
features that may be useful for you. Once you answer all the necessary questions and 
consider all the points mentioned in the chapter, you can build your contribution pages. Step- 
by-step documentation for doing that is available at 
http://wiki.civicrm.org/confluence/display/CRMDOC/Manage+Contribution+Pages. 

General Online Contribution Page 

Before you configure a general contribution page, ask yourself: 



• What contribution type will be used to categorize contributions received via this page? 

• Do you want to allow people to give in honor or in memory of someone? 

• What other data do you want to capture from your donors and contributors? These can 
be pre-defined CiviCRM fields or custom fields that you have created previously. The 
only field required by CiviCRM to process a contribution is an email address. Typically 
you will want to collect additional contact information for the contributor. These should 
be added using a Profile. 

Note: Whenever possible build the profile of fields that you will expose on the 
contribution form before you build your contribution page. A contribution page can 
include up to two profiles. If you do not create your profile before creating your 
contribution page, you can complete the process and return at a later time to adjust the 
configuration settings. 

• Can individuals contribute on behalf of an organization? This is most commonly used for 
membership sign-up pages (see below). 

• Do you want to allow people to pledge a certain amount as they contribute? A pledge is 
defined as a commitment to give a certain amount over a certain period of time. 
Pledges are a great way to allow your supporters to provide long-term support to your 
organization. 

• What are the amounts you want people to choose from? Some organizations call these 
"donation levels" and they're important because they give a potential donor a range and 
suggestions of what to give. You may also allow donors to complete an "other amount" 
field and ignore your predefined giving levels. 

• What text do you want to appear in the following? 

o The introduction of the contribution page 

o The footer of the contribution page 

o The text for the thank-you page 

o The automatic email receipt sent to the contributor (optional) 

• Do you want to enable the "tell-a-friend" feature? This allows donors to forward the 
page to friends, which can be very powerful in spreading your message throughout their 
social networks. 

• Do you provide premiums such as t-shirts, tote-bags, etc. to donors if they give a 
certain amount? If you do, be sure to set-up your premiums within the CiviCRM 
administration pages first. 

Once you have answered and resolved all of these questions, you can build your contribution 
page. Go to CiviContribute and click on Manage Contribution Pages » New Contribution 
Page. The options and settings should map pretty clearly to the choices you made for the 
questions listed in this section. 

Membership Sign-up Donation Page 

CiviContribute is closely integrated with CiviMember, the membership management 
component of CiviCRM. This means that your online contribution pages can allow people to 
join your organization at predefined membership levels. When people do, they create not only 
a membership record for themselves but a corresponding contribution record. 

Note: You must create all of your membership types and status settings within CiviMember's 
administration tools before you build your online membership sign-up page. 

Before building your membership sign-up page, you need to ask most of the questions listed in 
the previous section for the contribution page. A couple of additional questions include: 

• Should this page be used only for membership sign-up purposes, or can people give 
general contributions as well? Membership-based organizations usually use their 
contribution page only for membership sign-up which means they do not allow a variety 
of contribution amounts and membership sign-up is required. 

• Which membership types allow sign-ups? Some membership types in your organization 
may be for administrative use only. 

If your organization allows organizations as well as individuals to become members, you will 
need to allow individuals to join on behalf of an organization. Depending on your membership 



structure you may want to require this behavior. 

Campaign Fundraising Page 

In addition to the questions in the previous sections about how the contribution page will be 
used and what information it will capture, CiviCRM includes some exciting features for 
campaign fundraising purposes: 

• The campaign contribution page can have a start and end date along with a goal. You 
can then create a widget to embed on your website to show the progress of the 
campaign toward the goal (see below image). 
2009 Renewal 




• Wouldn't it be great if your constituents could do some of the fundraising for you? 
CiviCRM has a feature called Personal Campaign Pages (PCPs) that allow you to let 
people create their own fundraising page for your organization. This means a donor, 
after donating to your organization, can elect to create a page with her own photo, text, 
and personal information. She can then send a link to the page to her friends, soliciting 
support for your organization. This is a great way to widely and quickly spread the 
message about your campaign. 

When someone donates through a personal campaign page, a soft credit is given to the 
owner of the page to recognize the role she played in the contribution. CiviContribute 
has a section that allows you to administer all of the PCPs for your organization as well 
as moderate PCPs you don't approve of. Lastly, PCPs can have their own "Honor Roll" 
that highlights donors through that page (donors need to opt in to have their name 
displayed in the honor roll). 

Publicizing your campaign 

Now that you've created your contribution page, it's time to bring people to the page so they 
can contribute! Naturally you will display a link to the page prominently on your website 
through a donate button or menu item. Here are some additional tips for the different CiviCRM 
versions: 

• Joomla!: The most direct way to expose your contribution page or membership 
signup/renewal page to the front of your website is by creating a menu item. Navigate 
to a menu and create a new CiviCRM item. From the list of menu options choose 
Contributions. In the basic parameters section select the contribution page you would 
like exposed from the dropdown menu. Save the menu item and view the website to 
confirm the page's functionality. 

• Drupal: From the contribution page listing select "Live Page" to view the finished page. 
You can then copy the url and include it in a content page or assign it to a menu item. 

• Standalone: From the contribution page listing select "Live Page" to view the finished 
page and link to it. 



TIP: CiviContribute contribution pages have "ugly" URLs. In other words, they are difficult to 
remember. An example is : 

www.myorganization.org/civicrm/contribute/transact?reset=1&id=1 

You may find it useful to create a URL redirect (take people from one URL of your website to 
another automatically) on your server to take people to a "pretty" URL like : 

www.myorganization.org/donate 

Pretty URLs are much easier to remember and use in your organization's outreach. Creating a 
redirect requires some technical skill and access to your web server. 

For Drupal users, there is a helpful module called Path Redirect 

(http://drupal.org/project/path_redirect) where you can create URL redirects from the user 
interface without any technical skills. For Joomla! users who have Search Engine Friendly URLs 
enabled in Global Settings, creating a menu link to the contribution page will allow you to define 
the "pretty" url using the alias field. 

Emailing your current membership is the other critical way to publicize the campaign. The 
CiviMail component of CiviCRM allows you to send targeted emails to any group of contacts in 
your database. Within a CiviMail message you can include links to the contribution form and 
use CiviMail's tracking capability to see how many people click on that link. 

One time-tested way to increase contributions is to send each targeted constituent a 
personalized email with a link to the contribution form that has all of their contact information 
already filled in. This saves them the hassle of filling it out and raises the chances that they 
would ultimately donate. Using CiviMail, you can use this feature by creating a special link in 
the body of your CiviMail message that includes a checksum token. A checksum is a unique 
and pseudo-random number assigned to each recipient of the mailing that points back to their 
contact information that is securely stored in your database. 

When people click on the special link, CiviCRM looks them up in the database and pre-fills any 
information on the contribution form (core fields or fields exposed via a profile) with the 
corresponding data if it exists in their record. To read more on how to do this and what the 
link path must be, visit: http://wiki.civicrm.org/confluence/display/CRMDOC/Mail- 
merge+Tokens+for+Contact+Data 

Automatic Contribution Recording 

Regardless of how donors get to your contribution page, CiviCRM automatically records their 
donations, freeing your staff from doing manual data entry. If they already exist in the 
database, CiviCRM adds the contribution to their existing record. If they don't exist, CiviCRM 
creates a new record for them. 

To record contributions in the appropriate records, CiviCRM must identify the donor correctly 
by comparing the information they enter into the contribution page versus what exists in the 
database. By default, CiviCRM checks just the contributor's email address. In other words, if 
Judith Monroe has a contact record in CiviCRM with an email address of judith@example.com 
and she puts in that email address when she contributes, but with the first name of Judy, the 
contribution will correctly go into her record. If she puts in another address, such as a Hotmail 
or Gmail account, a new record will be created and you may have to manually clean it up 
later. Note that this is only applicable for anonymous users (those not currently logged into 
your website). Once a user logs into the website, CiviCRM recognizes them in the system and 
will attribute any activity to their record. 



We recommend that you configure CiviCRM to match contact information very strictly by 
changing the default duplicate matching rules. In our opinion, it is better to risk creating a new 
(duplicate) record for someone who is already in the database than to incorrectly credit their 
donation to someone else since it is not uncommon for multiple people to share an address 
such as info@example.org or judyandjim@example.com . We recommend you change the 
duplicate matching strict rule so that the first name, last name, and email must all match. 
This raises the bar on whether data is merged with an existing record or a new record is 
created. Using CiviMail's automatic fill-in feature (checksum token) will help avoid some of 
these issues. To configure your duplicate matching rules, go to Administer CiviCRM » Find 
and Merge Duplicate Contacts. 

OFFLINE FUNDRAISING 

Organizations have plenty of offline opportunities to raise money. You may pick up donations 
at events or solicit donations via postal mailings. For money raised through any of these offline 
activities, your staff needs to enter the results manually. 

There are three steps in offline fundraising: creating your lists, creating your mailings, and 
manually entering contributions. 

Creating your lists 

This process is fairly straightforward if you are familiar with CiviCRM's search capabilities. 

1. Create a list of records to receive your offline postal mail appeal (this can be your entire 
database if you like). If you want to later track the success of a mailing or if you are 
tracking who receives certain appeals, it is recommended you save the search results as 
a group. Later on, you can mark everyone in that group as recipients of that appeal 
using the Record Activity for Contacts option under the More Actions menu. 

2. From a search (whether a search of the groups' members or of other criteria) you will 
see a More actions dropdown menu that allows you to, among other things, export the 
list as a CSV file. Select all records or a subset using the checkboxes, choose export and 
click Go. 

3. As you export to a CSV spreadsheet, you can determine which fields you want to export 
to your spreadsheet and save the list of exported fields as an export mapping for future 
use. By default, CiviCRM will export a great deal of data, including contacts' names, 
contact information, email addresses, and phone numbers, and a list of their groups and 
tags. 

Creating your mailings 

Once your spreadsheet is created you can do a mail merge using any popular word processing 
software (such as OpenOffice.org the Free Software Word Processor) that will insert any fields 
you want in the letter. 

CiviCRM can also create mailing labels for you. Perform the same search you used in the 
previous section to create your list of recipients, but under the More Actions menu, choose 
Mailing Labels. Then select the mailing label number, determine whether you want to exclude 
people with "do not mail" checked in their privacy options (checked by default and 
recommended), and whether you want to merge two records that have the same mailing 
address into one label. This last option is very useful when you are mailing a household or 
organization and you don't want them to receive duplicate mailings. When the records are 
merged, each name at that address appears on its own line on the label. Once you click 'Make 
Mailing Labels," a PDF document will be created that you can print off. 

Note: Many nonprofit organizations in the United States have to sort recipients of a mailing 
based on zip code for bulk mailing purposes. If this is true for your organization, it is 
recommended you do not create your mailing labels within CiviCRM and instead create them 
using word processor merge functions where you have control over the sort order. You can 
reuse the same spreadsheet for the mail merge you exported in step 1. 

Entering contributions 



Hopefully your mailing is successful and contributions start pouring in! To manually enter a 
contribution for a record that is already in your database: 

1. Find their record using the contact search tools. 

2. Select the Contributions tab and click Record Offline Contribution. 

3. Complete the new contribution form (see below image). 

6 Richard Richardson 



Recently Viewed: wRirhard Richardson 



New Contribution 

Contributor Richard Richardson 

Contribution Type ■ |_ s „ lect _ y ; 



Total Amount • f J | Actual amount given bv contribirtor. 

Source f 1 Q 



Received 



Msy V '|06 v||_2D£9_v ! *< 

The date this contribution was received. 



Paid By | - select - ~M 

L**av* blank for nflrr-rnenstary spnrtnb«ti»ni¥. 



Transaction [I> 



Send Receipt? |_| Automatical I p *rriAll a rei&ipt For this •eentHh utiari to derfiofjpauiefm.org? 

Receipt Date — -™, ^, , ~ 

, -month- v | -day- v - Vea -- v 

D a Lis '.I . a", a -ece i pt w a s fl e nt to th j i6ntributtJ», 
Contribution Status I Completed »| 



Soft Credit TO 



Additional Deta*s 
Honoree Information 



Premium Information 



Note: If you have setup a payment processor that allows credit card transactions directly on 
your site you may select the "Submit Credit Card Contribution" option and process the 
payment immediately. The form is almost identical to the offline contribution form, with the 
exception of the payment related fields. 

On this form you record the contribution type, amount, received date (the default is the 
current day), receipt date, and status (the default is Completed). Any custom fields for 
contributions will also appear on this form. The "Additional Details" section near the bottom 
offers many other options, including adding a note about the contribution and entering the 
date when the thank-you letter was sent. The last two drop-down lists cover whether the 
contribution you are entering was in honor of someone else and whether there is a premium 
associated with the contribution. 

If the donor does not yet exist in the database you will need to manually create their record 
first. From the CiviCRM home page there are links to create new records called New 
Individual, New Organization, and New Household. Click on the appropriate link and fill out 
any information you have for this contact. Once the record is created, follow the same steps 
as above. 

Soft Credits 



The Soft Credit To field is a powerful CiviCRM feature. As mentioned earlier, if a donor sets 
up a personal campaign page (PCP) and their friends and family use it to make donations to 
your organization, some of the credit goes to the donor who set up the PCP. The person giving 
the money receives a "hard" credit while the owner of the PCP receives a "soft" credit. When 
you enter a donation manually on the contributor form shown above, you can assign a soft 
credit. 

Other uses of soft credits which can be managed using this form include credits to spouses, 
partners, or employers, enabling you to get a sense of how much money is coming from a 
relationship or providing a credit to employees if they urged their employers to donate. 
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CiviCRM provides several tools to help you obtain a quick snapshot of your members and 
search through your members based on various criteria. From the main sidebar menu, select 
CiviMember to view the membership dashboard page. This page contains two blocks of 
information providing a summary of your membership categorized by type and date range, 
and a list of recent member activity. 
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All of the summary numbers are hot-linked, allowing you to drill down and view a list of 
members who have joined or renewed over the last two months, the year-to-date, or are 
considered current according to the membership status definitions. 

The Find Members page displays a series of searchable fields to help you segment and locate 
membership records. It is important to note that searching using this tool will display a list of 
membership records. So if a certain contact has multiple membership records meeting your 
search criteria, the contact will be duplicated as all their membership records will be displayed. 
This is in contrast to the advanced contact search tool which displays one row per contact (i.e. 
there would be no duplicate listed, even if a contact had two membership records meeting the 
search criteria). 

Toward the bottom half of the form are a series of date range fields. The left column 
indicates the From value and the right column the To value so you can narrow down searches 
to between two particular dates. If you are interested in membership records before a 
certain date, only use the to field. Conversely, if you are interested in membership records 
after a certain date, only select the from field. 

At the top of the search result set is a shaded block with tools to take action on all records in 
the result set or those selected using the checkboxes in the leftmost column. 
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The actions are as follows: 



Batch Update Members Via Profile: Use this option to edit multiple records in a table 
grid using a pre-defined profile. If you are not familiar with how profiles work, you will 
want to investigate how they are created before using this function. As you use this 
tool, note the following: 

o You must have a profile created before using this option. 

o Your selection of contacts must be of a single contact type. You cannot edit 
Individual and Organization type contacts simultaneously. 

o You may only edit a maximum of 100 records at a time. If your search result set 
exceeds 100, use the record selection checkboxes to edit a single page of records 
at a time. 
Delete Members: Delete their membership records from the database. Note: you are 
NOT deleting the contacts only their membership records. This action cannot be 
undone. 

Export Members: After selecting this action you will have the option of exporting a 
default set of primary fields or choosing which fields to export. When selecting which 
fields to export you may save the mapping for future use. The data is exported in CSV 
format and can be easily modified further in spreadsheet software or used for document 
mail merges. 

Send Email to Contacts: After searching your records, you may send an email to 
selected contacts and include data field tokens. Tokens are placeholders that are filled 
with the contact's data when the email is sent. This is incredibly valuable as you are able 
to send a bulk email to contacts while customizing it to each contact (e.g. beginning the 
email with a personalized salutation). 
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CONFIGURING AND PLANNING 



CiviCRM provides powerful and exciting tools for managing events and provides real-time 
registration forms through your website (CiviEvent). By harnessing the power of CiviCRM you 
can centralize your registration data process, provide your constituents the ability to register 
online with credit cards, and even have live access to your data while onsite at the event. 

Before diving in to the event creation process, there are several global settings you will need 
to configure and concepts you should understand. 

The chart below demonstrates the basic structure and functions of the event management 
process. 
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GLOBAL EVENT CONFIGURATION 



CiviEvent has three global settings that must be reviewed and configured before you can 
proceed with the event creation process. In addition, there are three general CiviCRM settings 
that should be reviewed and configured. 

NOTE: If you do not see links to CiviEvent from your CiviCRM home page or in the Administer 
CiviCRM page, you may not have the component enabled. Navigate to Administer CiviCRM » 
Global Settings » Enable Components to manage which components are enabled. 

Navigate to Administer CiviCRM and note the CiviEvent block towards the bottom of the 
page. You will need to review the following settings: 



Event Types: CiviCRM allows you to define different types of events as a categorization 
mechanism. This is particularly useful when searching through event participants or 
generating an event listing feed. You should take the time to consider what types of 
events your organization holds and define them in this interface. You can return at any 
time to modify or add to the list of types. 

Event Type Options 
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Use Event Types to categorize your events. Event feeds can be filtered by Event Type and 
participant searches can use Event Type as a criteria. 
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Participant Roles: When an individual registers for an event, they will be assigned a 
participant role. This field helps you segment your participants into meaningful categories 
based on their involvement in the event, such as attendee, volunteer, speaker, staff. 
You are also able to define custom fields and assign it to a specific role, which can be 
helpful when you need to collect certain information relevant only to speakers or 
another role. Participant roles can be searched for using the Find Participant dialogs. 
When creating a registration page for inclusion on your website, you will select a default 
participant role assigned to all online registrants. 

Participant Role Options 
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Define participant rales for events here (e.g. Attendee, Host, Speaker,..). You can then assign roles and 
search far participants by role. 
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Participant Status: The participant status field set allows you to track the individual's 
registration through your system. Depending on the level of detail and tracking you 
need, this can provide you with the ability to identify cancelled registrants, no-shows, 
confirmed attendance, or any other status you define. Participant status is also a 
searchable field in the Find Participants form. 



For organizations that need more of an RSVP workflow, you can rename your statuses 
to friendly names such as "Yes, I'm Coming; No, I can't make it; and Maybe." Then 
configure for each of those statuses which ones are for admin use or public use. This 
allows you to expose the participant status field via a profile on your registration form 
and only those with public visibility will appear. For more information on this scenario, 
visit: http://wiki.civicrm.org/confluence/display/CRM/RSVP-style-i-Event-i-Registration 

In many cases you may find that the default options for Participant Roles and Participant 
Status are sufficient for your needs. But it is important to review them before proceeding to 
ensure you have structured event management to fit your organisational needs. 



There are several core CiviCRM settings that may play an important role in how you use the 
event tools. It is possible that you have already reviewed and configured them as part of your 
initial installation process. But it is worth reviewing the following configuration options: 

• Administer CiviCRM » Global Settings » Outbound Email (SMTP/Sendmail): 

CiviEvent makes significant use of the system's email capabilities, providing very 
valuable functionality. If a contact registers for an event online or an administrator 
registers a contact through the administrative interface, an email receipt can be sent to 
the contact with details of their registration transaction. In order for these functions to 
work, you must complete and test the Outbound Email settings. 

• Administer CiviCRM » Global Settings » Payment Processors: While not required, 
the event registration process is significantly enhanced by allowing individuals to register 
and pay for the event with a credit card. CiviCRM can be configured to use several 
payment processors, all configurable through this interface. Please visit the online 
documentation for more details on using payment processing 

(http://wiki.civicrm.org/confluence/display/CRMDOC/CiviContribute+Payment+Processor+Configuration 
. Once you have created a payment processor you can select it in the event creation 

fees page. 

PLANNING EVENT MANAGEMENT 

In addition to the configuration steps above, you should familiarize yourself with various tools 
available in the event creation process. Some of these require you to take steps prior to the 
actual creation of an event (though if you've already begun creating an event you can always 
complete the process, address these tools, and return to complete the event configuration). 

The two essential tools you should understand are Custom Data/Profiles and Price Sets. 
Custom Data/Profiles 

CiviCRM provides ample flexibility for you to define and integrate custom fields into your event 
management process. Custom data are fields that you define and associate with a specific 
data type. You can then use them to collect information from your contacts as they register 
for an event, as well as in other ways. 

Custom data is managed through Administer CiviCRM » Custom Data. You begin by creating 
a new group of custom fields, at which point you designate how the set of fields will be used. 
There are several types of uses available to CiviEvent tools: 

• Events (Event Type): This use type will create fields that are connected to the event 
itself, or to a specific event type. For example, your organization may host a series of 
training workshops and want to create a custom field to track the topic fields covered 
by the event from a list of six common topics. You could create a checkbox style field 
with the list of topic options. When creating an event using the "Workshops" type, this 
field will be available. Note that you are not required to select a specific event type. 
Leaving the dropdown set to "Any" indicates the field is available to all events, 
regardless of the type. 

• Participants: The Participant use type attaches to the actual registrant record. For 
example, you may want to know if a registrant has any dietary restrictions and collect 
that information at the time they register. 

• Participants (Event Name): This use type is identical to the Participants type, with the 
exception that it allows you to assign a group of custom fields to a specific event. 
Returning to the example above, you may find that the dietary restrictions field is only 
applicable to the upcoming full-day workshop where lunch will be served, but not to the 
afternoon workshop series you are planning for the coming month. You could create the 
field set and assign it to a single event. 

• Participants (Role): Additionally, you may create a participants type field and assign it 
to a single participant role. This is valuable, for example, if you need to collect 
biographical profile details from your speakers and wish to record it with the event 
registration. Because that field is applicable to only the Speakers role, you would limit it 
using this interface. 



After creating your set of custom fields you begin defining the actual fields to be included. If 
you are not familiar with the range of options available through the custom fields tool you 
should investigate that further before creating your actual fields. 

Participant custom data groups and fields will be automatically included in their assigned 
location when accessing the information through the CiviCRM administrative tools. However, 
they will not be displayed in your online event registration page unless they are first included 
in a profile, which is then included with the event configuration. 

A profile is a collection of fields (both pre-defined and custom) from your database, acting as a 
"window" into your data. By creating a profile you are able to pull only those fields relevant for 
a specific purpose and then incorporate them into your event registration or other online tool. 
If you are not familiar with how profiles are created and configured, please research that 
before continuing. The diagram below provides a visual explanation of how existing fields are 
assigned for use in a profile. 




Thinking ahead and planning your data needs before you create your event will help streamline 
the event configuration process. But it is not uncommon for people to begin the event creation 
process, and perhaps get to a testing stage, before they realize that there is an additional field 
they need to capture through a custom field and profile. Don't worry — after creating your 
event you can always return to the configuration and assign a profile(s) at a later stage. 

Price Sets 



Price sets play a similar role to custom data fields and profiles except that they are used to 
provide event fee options rather than basic data collection. 

When creating a new event, one step in the process involves configuring event fees. The 
standard fees layout form is a very simple structure, allowing you to create a list of fees and 
their labels. The resulting layout allows the registrant to select one option from the list. Often 
times, this single-option format does not meet the complex demands of your event 
registration structure. Price sets allow you to create multiple registration fee fields and assign 
the entire set to an event. 

Price sets are created and managed through Administer CiviCRM » Price Sets or as an 

option under CiviEvent in the sidebar menu. 

Similar to how custom data sets work, you begin by creating a new price set and then adding 
specific fields. The field types are similar in structure to custom data fields, with some unique 
qualities and usage relevant to fee structures. 
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• Text/Numeric Quantity: This field type allows you to set a unit price and displays a 
text box where the registrant enters a quantity value. The quantity entered is multiplied 
by the unit value to calculate the fee. 

• Select: The select field option displays a drop-down box where the registrant selects 
one option from the list. 

• Radio: Radio fields display multiple options in a list, allowing the registrant to select one 
fee choice. 

• Checkbox: The checkbox fields are displayed in a list, but the registrant can select or 
unselect any number of options. 

Using these four field types, the administrator can define any number of registration fees in 
combination with each other. The result is a robust and flexible system for managing event 
fees. 

As with custom data fields, it is to your advantage to give thought to the structure of your 
registration fees and build the price set before creating the event. However, if you begin the 
event creation process and determine that you needed to construct a price set, you can 
complete the process, create the price set, and then return to the event configuration page to 
assign the price set. 

Also note that price sets can be reused in multiple events. This is particularly helpful for 
organizations that run multiple events in a series, such as a regional training seminar program. 



25. 



CREATING AND PROMOTING 



This chapter will deal with the details of creating, configuring, and promoting an event in 
CiviCRM. CiviEvent, the event management component in CiviCRM, is a flexible and powerful 
solution for your event organisers, enabling them to collect registrations online, process 
participants, view and search through event registrants. 

CREATE AN EVENT 

To begin the event creation process, click CiviEvent from the CiviCRM home page and select 
"New Event" from CiviEvent main page. The event creation tools are organized into a series of 
"wizard" pages, each of which provides you a series of options to consider. 

t CiviEvent 

h Find Participants 
n Manage Events 
h New Event 
h Import Participants 
b Manage Price Sets 

These options are numerous, allowing your organisation to take advantage of various fee price 
mechanisms, configure date-based discounts, permit batch registrations — all while remaining 
confident that CiviCRM is managing the records and calculating the fees accurately. 

As we walk through each page of the event creation wizard we will demonstrate the options 
and their effects on the resulting registration form through screenshots and examples. 

1. Event Information and Settings 

The first page in the event wizard requests basic information about the event: 



What is the type of event that you are setting up? If you have not done so already, 
please read about how to create suitable event types through Administer CiviCRM » 
Event Types. 

What role will participants be assigned to when they register online for this event? Roles 
are used to distinguish different types of event participants, such as attendees, 
speakers, and staff. The value placed in this field will be assigned by default when users 
register online. The most common value is "attendee." You may manage participant 
roles through Administer CiviCRM » Participant Roles. 

Do you want users to see a listing of participants, and how much information about the 
participants do you want to reveal in the listing? Participant listings are a great way to 
demonstrate support for an event and generate interest within your constituent 
community. Note that the options you define in this section only enable participant 
listings — you will still need to create a menu item or link to the listing somewhere on 
your website. 

Configure Event - Beginners Stilts Class 
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Event Information 

Event Type Workshop ~B| 

After selecting an Event Type, this page will display any custom event fields for that type- 



Participant 'Attendee |»| 

Role The Role you select here is automatically assigned to people when they register online for 
this event (usually the default 'Attendee' role). P 

Participant ' Name and Email % ' 
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What is your event title? The title will appear on event information pages, registration 

pages, event listings, and in the Manage Events administrative page. Be sure to choose a 

descriptive, well-crafted title to represent your event. 

The next two fields (event summary and complete description) provide space for 

describing your event. Both the summary and complete description will be included on 

event information pages. 

What is the start date/time and end date/time for your event? These will be included on 

the event information page and event listings. It is also important if you are using a 

calendar widget to display upcoming events. 

CiviCRM provides you with the ability to set a maximum number of participants for each 

event. This is important, as online registration removes some of the control from the 

hands of administrative staff. You can set the maximum number of participants and 

define a message to be displayed when that number is reached. 
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Optionally set a maximum number of participants for this event. The reqrstratlor link Is 
hidden, and the text below is displayed when the maximum number of registrations is 
reached. Participants with Pending or Cancelled status are NOT included when checking if 
the event Is full. 



Text displayed on the Event information page when the maximum number of registrations 
is reached, if online registration is enabled, this message will also be displayed If users 
attempt to register 

Q Include Map Link? 

Include a link to map the event location? (A map provider must be configured under Global 
Settings » Mapping) 

O Public Event? 

Include this event im iCalendar feeds? 

el Is this Event Active? 



• In today's world, people are increasingly using GPS and web-based mapping tools to get 
where they are going. CiviCRM anticipates this need by integrating the ability to enable 
Google Maps or Yahoo! maps throughout your site. You will first need to configure your 
mapping solution through Global Settings » Mapping. You can then enable a map link 
which will generate the location based on the address settings for your event. 

• Once you have created your event and placed the information and registration pages on 
your website, you naturally will be looking for ways to promote the event. CiviCRM 
provides several ways to do that through RSS feeds, iCal files or feeds, and event listing 
pages. Selecting "Public Event" on this page will include the event in these promotional 
listings. 

• Lastly, you have the option of toggling this event active or inactive. If you anticipate it 
will take some time to complete the configuration of your event, consider disabling it 
until it is complete to ensure it is not inadvertently listed on the event listing feeds. You 
can easily activate the event at a later time when you are ready to begin publicizing it. 

After reviewing the details on this page, click continue to advance to the next step of the 
wizard. 

2. Event Location 

The next step in the event configuration process is to complete the location and contact 
details for the event. Though optional, it is highly recommended that you take the time to 
provide these details to your potential participants. If you have enabled a map link in the 
previous step, you will need to make sure that you fully complete the address details on this 
page. Also note that you are able to list phone numbers and email addresses for registrants or 
interested individuals to use when registering for the event. This is particularly helpful if the 
event will be held off-site from your organization's primary location and you want to provide 
contact information for the meeting location. 



Event Location and Contact Information 

Use this form to configure the location and optional contact information for the event- This information 
will be displayed on the Event Information page, It will also be included in online registration pages and 
confirmation emails if these features are enabled. 



Choose Location 

Address 
Street Address 

Addt'l Address i 

Addt'l Address 2 

City 

Zip / Postal Code 

Country 
State/Province 
Latitude, Longitude 



9 Create new location 
_ Use existing location 



Street number, street name, apartment/unit/suiie - OR P. O. box 



Supplemental address info, e.g. tjo, department name, building name, etc. 



Supplemental address info, e.g- c/o, department name, building name, eft 



Enter optional J add-on' code after the dean ('plus A' code for U.S. addresses}. 



{ - select ■ 



■ select ■ 



Latitude and longitude may be automatically populated by enabling a Mapping 
Provider, (learn more..,} 



Email (preferred) 



Show Location? 



another email 



Phone (preferred) ' - select - rrf " 



[3 another phone 

M 

Uncheck this bo> if you wamt to. HIDE the event Address on Event Information and 
Registration pages as well .as on email confirmations. 



3. Event Fees 



CiviCRM provides the ability to manage both free and paid events. If you plan to assess fees 
for participation in your event, this third step in the wizard will walk you through the options 
available. Note that if you plan to accept credit card payments through the online registration 
form you will need to configure a payment processor prior to completing the details in this 
section (Administer CiviCRM » Global Settings » Payment Processors). 



What contribution type will paid registrations for this event be recorded as? While the 
most common value for this field is simply "event fee," CiviCRM provides flexibility to 
define multiple contribution types and assign them to different events as needed. 
Do you want the participants of your event to pay later by mailing in a check, paying on 
site with cash or credit card, or to arrange other payment details? If so, you can enable 
the "Pay Later" option and define a label and payment instructions. Note that if you 
keep this unchecked, registrants will be required to pay by credit card. 

Paid Event g ¥es Z No 
Payment Processor ' pp p ro j^J 



If this is a paid event and you want users to be able to register and pay online, select a 
payment processor to use. NOTE: Alternatively, you can enable the Pay LAter feature 
below without Kiting up a payment processor. All user? will then be asked to submit 
payment offline {e.g. mail in a check, call in a credit card, etc.). (learn more.,.) 



Contributio-rt Type * ' Event Fee 



This contribution type will be assigned to payments made by participants when they 
register on line. 



Fee UtMl * Event fee(s) 

This label is displayed with the list of event fees.. 

M Enable Pay Liter option? 

Chech this twx if you want to -give users the option to submit payment offline (e.g. mail in 
a check, calf in a credit card, etc.). 



Pay Later Label * 



I will send payment by check 



Text displayed next to the checkbox for the 'pay later' option on the contribution form. 



Pay Later Instructions Maj( p 3ymen t to: Beginner's Stilt Class, PO Box 123 P New Zealand 



Do you want to use price sets that provide you with the ability to break an event into 
smaller pieces and charge for each selected piece or will you use the basic event fee list 
(single set of options where the registrant can select a single option)? 

Event fee price sets are an incredibly flexible and robust tool for building complex fee 
structures for your events. Please take time to review their functionality and 
understand how they can benefit your event management process. 

CiviEvent in Action 

Wellington Circus Trust hosts a periodic "Stilts Class" in which they offer different price 
options using a price set: a standard fee or performer rate fee, and an additional $5.00 
charge if attendees wanted to hire (rent) stilts. When the attendee completes the 
registration process, the total amount from their particular choices will be calculated and 
added to the total. The image below shows how the fee section of their registration 
form appears. 



Beginners Stilts Class 

Event Fee(s) 



Standard Fee * ©standard Fed -* 16S.00 

tj Performer rate fee - t 150.00 

Stilt Hireage required g 2 nee(J tQ hjre ^ ($s ^^ 
Total F*e(s) * 170.00 



[x] I will send payment by check 



Email Add r hs * attendee@mtBketraining.com 
Emergency Contact info 
Emergency Contact phone number * 



f Continue » } 



Do you want to give early bird discounts for event fees (discounts by signup date)? 
CiviCRM provides you with the ability to specify date-based discounted fees that 
override regular event fees. Note that these are only available to the basic event fee 
structure; you cannot implement discounts with price sets. 



Discount Sill 



Early Registration Discount 



May 1 ! 

OS t+j 



May 



3 



3 



E another d=stount set 
(Add Discount Set to Fee Table J 



D 500 lint ed Fees 



Use the table below to enter descriptive labels and amounts for up to ten discounted event 
fees for each discount set, Don't forget to click 'Save' when you are finished. 



I Label 



Early Registration 
Discount 



Default? 



Early Registration Discount before June l t 2QQ9 $ 100 



Standard Fee 



S 165 



Performer Rate 



: 



Discounts are structured in parallel with the base event fees. After creating your list of 
fee options and enabling the discounts feature, you must create the discount set and 
add it to the fee table. A new fee table will appear toward the bottom of your page, 
duplicating the original fee table (see above). You can now edit the labels and fees to 
correspond to the discounts offered for each of the original fee options. 



CiviEvent provides the flexibility to create multiple discount sets to an event. This may 
be useful if you have a series of early bird dates that progressively increase the cost of 
registration as the date of the event gets closer. 

4. Online Registration 

While CiviEvent can certainly be used in only an administrative capacity, where staff enter 
event registrants as they are received by mail or phone, the real benefits are realized when 
the event registration form is made available to your constituents through your website. 

In step four of the event creation wizard you can enable online registration and configure the 
options for this feature. 



Begin configuration by defining the text to be used as the link to the registration form, 
and setting the start and end dates for registration. The link text is used in the event 
information page, and is most commonly "Register Now" or something similar. The start 
and end dates define when website visitors may register for the event. The registration 
end date is likely different from the start date of the event, as you may want to close 
registration in advance of the event in order to prepare name tags or perform other 
administrative functions. 

Very often an organization may choose to send multiple people to a conference or an 
individual will bring her partner and wish to register and pay for the registrations in a 
single process. By enabling the "register multiple participants" checkbox you provide a 
mechanism for an individual to register as many people as they choose for the event 
and pay the fees with a single transaction. By default, this option requires a different 
name and email address for each person registered. Enabling the "allow multiple 
registrations from the same email address" checkbox provides the same capabilities, but 
without requiring distinct email addresses for each registrant. Note that in either case, 
CiviCRM will connect with an existing record or create a new contact record for each 
individual registering for the event. 

What other data do you want to capture from your participants as they register? By 
default, the CiviEvent registration page only includes and requires an email address from 
the registrant. Organizations typically want to collect additional contact information from 
the registrant, as well as define fields unique to this particular event (such as dietary 
restrictions). This is done through the creation of custom data fields and the 
configuration of profiles. Profiles are collections of data fields that can be included in 
event registration forms and used for other purposes. 

Note: If you are not familiar with the creation and function of custom data fields and 
profiles, please take time to review their functionality. In particular, examine the custom 
data types available to events and participants. 

The Registration Screen configuration block is used to define introductory and footer 
text for your registration page, and to select which profiles should be included in the top 
and bottom regions of the form. If you come to this stage in the wizard and have not 
created your profile form, you may continue with the event setup process and return to 
the event configuration page at a later time to select your desired profile(s). 
The remaining fields on this page control the text to be displayed on the confirmation 
page, thank you page, and emailed receipts (if enabled). The standard page flow is as 
follows (the event information page is sometimes bypassed depending on how you plan 
your event promotion): 



EVENT 
INFORMATION 

Lists event date, 
location, iii'i|: liiU, 

contact informatiwir 

srid description. 

Includes, link to 

registration page. 



EVENT 
REGISTRATION 

Registrant completes 

form, including evenvt 

■fees, profile folds, 

and credit card or pay 

later fields 



« 



CONFIRMATION 

Details the event fee 

;;fiii:i:v> ,=ii::: ::,^,i 
Mds cornptetedbry 

the registrant 
Proceeds to credit 
card transaction. 



THANK YOU 

Displays thank you 
message afid tnio-rms. 

r^istfant that they 

will receive a receipt 

by email. 



When completing this page, take care to think about the user experience at each stage 
in the process. Ensure that the text is appropriate to the point in the registration 
process where the registrant currently is. 



5. Tell-A-Friend 



Leverage the social networking power of your committed constituents by empowering them 
to quickly and easily share details about your organization and event with their friends and 
colleagues. The final step in the Event Creation wizard is a page where you can enable "Tell-A- 
Friend" capabilities and define the text and links to be included on that page and in the email 
sent from the tool. Note that the people who are emailed using this feature are automatically 
added to CiviCRM. 



PROMOTING YOUR EVENT 

Now that you have completed the creation of your event you should test it and then find 
ways to begin promoting it. Returning to the Manage Events page you will see your recently 
created event listed with any others you have created. From the action list, select Test-drive 
to test the registration page. Test-drive mode will use the Sandbox options for your payment 
processor, if available, and will create a registrant record with a "test" indication so that it can 
be reviewed and easily removed. If you have events where anonymous users register for 
events, you should also test the registration when not logged in. 

If you discover elements that you need to edit and adjust, select Configure to return to the 
list of event setting pages. Once you are satisfied with the event information and registration 
form, it's time to display it on your website. If you are using Drupal, select the "Live Page" link 
to obtain the url. You can then create a menu item or link to the form from a page on your 
site. Injoomla!, use your menu manager to create an Event Information or Event Registration 
page. You may also link to the event information page from an article using the following url 
(replacing the EVENTID with the value for your event as displayed in parentheses by the title): 

http : //www . reorganization .org/index . php? opt ion=com_civicrm&task=civicrm/e vent /ir 

The url to directly access the event registration page injoomla! is (again replacing EVENTID 
with the id as displayed in the manage events page): 

http : //www .myorganization .org/index . php? option=com_civicrm&task=civicrm/ event /re 

Creating a direct link to the event information or registration page is central to your event 
promotion efforts. But CiviCRM provides several other ways to publicize your event. 

Navigate to the Event Summary page (CiviEvent link in the main menu), where you will find a 
series of icon links above the summary table. These links provide helpful ways for you to 
display a list of upcoming events on your website or through email. They are as follows: 

• HTML listing of current and future events. This list will display in your website using your 
site template/theme. 

• RSS Feed: Display a feed to your upcoming events on your website. The standard feed 
format (RSS 2.0) provides flexibility for including the list of events in a module/block on 
your site, or simply providing visitors a link to the feed for incorporation in their feed- 
reader of choice. 

• iCal download file: Download an iCal file and import into your calendar software of 
choice. 

• iCal Feed: Obtain an iCal feed link for synchronization with your calendar software of 
choice. 

Congratulations! — you've created an event and begun promoting it on your website. CiviCRM 
has provided you with the ability to display event registration forms and collect registrations 
online in real-time. You've taken an important step toward streamlining your event 
management system, reducing data entry by staff, and providing your constituents valuable 
new benefits. 



26. 



MANAGING PARTICIPANTS 



Once you've created your event and provided the registration form to website visitors, you 
will need to begin managing your participants through the CiviEvent administrative tools. 
CiviEvent provides the ability to register participants administratively, search through 
participants based on a variety of criteria, export participant lists, and perform a number of 
other functions on your event records. CiviEvent not only gives participants a smooth journey 
from registration to payment to attendance at the event, but also lightens the burden of 
administrative duties on your organisation's staff. 

An events' administrator at your organization can view an intuitive events dashboard that 
brings together all your events and participant information in one place. In this section we will 
discuss how these administrative tools are used. 
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Registering a Participant 

While CiviCRM helps alleviate data entry for event registration by allowing your constituents to 
register directly through your website, it is likely that you will continue to have a segment of 
your contacts that continue to register by mail, phone, or in person on-site. 

As with other functions in CiviCRM, you register a contact for an event by first locating their 
contact record, and then selecting the Events tab. This tab displays a summary list of past 
event attendance and provides a link for registering the contact for a new event. 




Summary Co ntntnubons Pledges Memberships Events Activities Relationships Groups Notes 
Tags Change Log 

Tn*s page lists an -event registrations, lor Sam s>am since inception,, ok*. New Event Registration to register this contact for an 
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You'll notice that there are two options available for registering the contact: "new event 
registration" and "submit credit card event registration." The latter will only be available if 
you've configured a payment processor that allows direct payments through your website. The 
first option is used for offline registrations — those that do not require actually processing a 
credit card. The interface for both options is very similar, with the exception of those fields 
that impact the payment recording details. 

After choosing to create a new registration for this contact, you are taken to a form where 
you complete details regarding the record. 
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As you work through this form, you'll notice certain sections of the page may change to 
reflect selections you have made. For example, when you choose the event you want to 
register the contact for and select their participant role, the form will automatically load 
predefined custom data fields that pertain to those selections. 

If the event selected is a paid event, you will see an event fees section which has been 
defined in the event configuration details, and an option to record the financial transaction 
details will be visible (Record Payment). 

This introduces an important concept central to CiviCRM's event function (as well as other 
areas). Event registration records in CiviCRM are independent of, but can be related to, a 
financial transaction. While this may seem confusing to organizations accustomed to viewing 
event registrations as essentially a financial transaction, it offers an important and valuable 
distinction. 



An event registration communicates the contact's participation in the organization's event. A 
corresponding financial transaction indicates the monetary value associated with that 
participation. While related, the two are distinct. 

The distinction is best understood by considering the all too common scenario of an 
organization waiving fees for certain attendees. This may be done because the individual is a 
V.I. P., a speaker, or is participating in the event in a limited way. Regardless, the organization 
will want to record the individuals involvement in the event by registering them, but may not 
want to create an associated financial transaction. 

CiviCRM respects this distinction by recording the event registration record under the Events 
tab, and the Financial record under the Contributions tab, and then creating a link between the 
two records. 



Create 
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wTth 
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Transaction 

(Record Payment) 
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Record 



4* 



Contribution 
Record 



By clicking the Record Payment checkbox and completing the transaction fields that are 
displayed, you are building these two associated records. After recording the membership, you 
will be able to view the event registration record and see the related contribution record at 
the bottom. If you do not select the Record Payment checkbox, only a registration record will 
be created. 
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Bulk Registration Action 

A great time saving feature that CiviCRM offers is bulk registration for an event. Using this 
feature you can register a group of contacts simultaneously. 

1. Search for the contacts you want to register for a particular event 

2. On the search result page, click "select all" or use the checkboxes to select only those 
records you wish to register. 

3. From the actions dropdown box, select "Add Contacts to Event" and click Go. 

4. Complete the participant registration form. 

Note that when registering multiple participants for an event using this tool there are two 
limitations: 



You are not able to define different registrant settings for each individual, as they are all 
recorded based on the same form fields. However, after recording the registrations, you 
can go into each record and modify the registration as needed. 
You are not able to record payments with the registration. Since each individuals 
payment for an event will likely be distinct from the other registrants, CiviCRM does not 
provide the option of recording payment details. For this reason, the bulk registration 
tool may be best suited for free events or registrants who are not required to pay 
fees. 



Bulk Import Registrations 

Another way to register a large number of individuals quickly is to import registrants from 
another application using a "comma-separated-values" format file (CSV). 

This can be very convenient in a number of situations. Your organization may be collaborating 
with another organization for a specific event where the other organization has a preferred 
events registration system other than CiviCRM. Or perhaps a volunteer in charge of the event 
with no experience using CiviCRM recorded registrations with MS Excel. In these cases it is still 
important to capture inside CiviCRM those individuals who have registered through these 
alternative methods. Importing the records into CiviCRM will help consolidate your information 
and allow better interactions with your contacts in the future. 

Importing records involves preparing your data, and then walking through the Import 
Participants wizard. 

It is ideal if the records to be imported contain data that can uniquely match to an existing 
contact in your CiviCRM database. In general, the first name, last name and email are used for 
this purpose. Be aware that even slight variations in these values can inadvertently create 
duplicate contact records, you may want to run deduplication rules after the import in order 
to identify and merge duplicate records. 

In some cases where there are only a few registrants to be imported and they already exist in 
CiviCRM, it may make sense to use the bulk registration action above. But usually when there 
is a significant number of registrations, including registrants who are not currently in your 
database, it will be faster and lead to less errors if you process a bulk import and deal with 
deduping efforts after the import. 

FIND PARTICIPANTS 

Up until this point we have focused on how to register contacts for events and review past 
event participation for each individual through the contact's Events tab. But one of the most 
important functions of any event management tool is the ability to search for participants and 
quickly pull up attendance lists for an event. 

Returning to the main event dashboard page (by clicking the CiviEvent menu item), you notice 
that the list of upcoming events includes several hyperlinked options in the attendee summary 
column. 
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The hyperlinked options available will depend on your registrants to date. For example, if you 
have no Registered/Attended status records, the text would not be hyperlinked. Selecting one 
of the options quickly displays a list of the registrants meeting that criteria for the event. 

CiviCRM also provides event participant search tools, accessible by clicking Find Participants in 
the CiviEvent submenu. The resulting search form provides the ability to search by participant 
name, event name, event type, event dates, participant status, participant role, fees, pay 
later registrants, and any combination of the above. 
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After conducting a search you have the opportunity to select all of the resulting records or a 
subset, and to perform an action on the records. The actions available include: 

• Batch update participants via profile: This feature is useful if you wish to edit multiple 
fields for multiple participants in a table grid layout. Note that you must create the 
profile set you wish to use before implementing this action. If you are not familiar with 
how profiles work, please investigate that before using this feature. 

• Cancel event registrations for the selected participants. 

• Delete participants: Deleting participants does not delete the contact record but will 
delete all transactions and activities associated with the participant. Note that this 
action cannot be undone. 

• Export participants: The export function is one of the most useful tools available to 
event managers, allowing you to export a predefined set of fields or create your own 
custom set of fields (which can be saved for reuse). The software exports to CSV 
format which can be easily opened in standard spreadsheet software or directly used for 
mail merges. 

• Create a new smart group: Smart groups are saved search results based on defined 
criteria, similar to a query. The advantage of a smart group is that the system will rerun 
the query using the criteria you have defined each time you open it. This is particularly 
helpful for more complex search criteria that you need to view on a regular basis. 

• Send an email to selected participants: CiviCRM also lets you generate an email on 
the fly to your search result list. For example, you may want to let recipients know 
details about the event in advance, such as parking options or local area restaurants for 
those arriving early. 

ADDITIONAL SEARCH TOOLS 



CiviCRM has several pre-built custom search pages available through Find Contacts » Custom 
Searches that provide advanced tools for event management. 



• Event Aggregate: This report generates the total amount of fees collected for events 
based on the criteria provided in the search form. In essence, this provides a way to 
"connect" your event registrations with their corresponding contribution records and 
generate a total. 

• Price Set Details for Event Participants: Because of the potential complexity of price 
sets it can be difficult to easily generate totals for each price field using the standard 
event search interface. This custom search displays price set details for a specific event 
as a table, which can be easily exported and used for developing reports. 

TIP for Drupal users: When using Drupal CMS, you should ensure that registering user has 
correct permissions. For example, if an anonymous user wants to register for CiviCRM Events, 
he needs to have "register for events" permission. If a profile has been included in your event, 
you need to have "profile listings and forms" permission as well. 
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CONFIGURING MEMBERSHIP 



CiviCRM provides a suite of tools that allows you to track and manage membership records 
and to view a snapshot of who your current members are at any point in time. You can 
manage your memberships more easily by allowing individuals and organizations to become 
members or renew an existing membership online. 

Bothjoomla! and Drupal have extensions available to control access to website resources and 
allow user registration based on membership status. Visit the CiviCRM website for more 
details. 

Before you begin using CiviCRM's membership tools with your contacts you will need to 
configure several elements and give some thought on how your records will be organized and 
used. 

CONFIGURING MEMBERSHIP TYPES 

The first step toward implementing CiviMember is to configure the membership types and 
status rules. These are handled in: Administer CiviCRM » CiviMember » Membership 

Types ( Drupal: http: //siteurl/civicrm/admin/member/membershipType?reset=l ). 

Membership types are the various membership categories that your organization offers. You 
can configure an unlimited number of membership types and set various options for each of 
them. Options include how they are used, the membership term period, and the dues amount. 
The below image displays the various options. 
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Begin by defining the name of the membership type and a brief description. The name will be 
used throughout the system so be sure to choose it carefully. CiviCRM requires the 
membership type be associated with an organization record. 



Having each membership type is connected with an organization gives CiviCRM the flexibility to 
handle multiple membership types with multiple organizations (or sub-organizations) within a 
single interface. For example, if your national organization consists of 6 regional chapters, each 
of which maintains membership records separate from the national membership, you can 
create membership types for each chapter membership and associate it directly with the 
chapter organization. 

Continue through the membership type configuration by entering the minimum membership 
fee (zero if the membership is free), and select the contribution type. When a user or 
administrator logs a membership record in which a fee is recorded, CiviCRM will log a 
corresponding contribution record and assign the selected contribution type. In most cases you 
will select "Membership Fee" from the dropdown. You can create and modify Contribution 
types through the Administer CiviCRM tools. 

Each membership type must have a duration value and period type selected. The duration 
value is the length of time for which the membership is valid (e.g. an annual membership has a 
duration of 1 year). The period type determines when that duration is measured from. A rolling 
membership is measured from the date it is entered in the system, whereas a fixed 
membership begins on a defined date. For fixed period memberships you must also identify 
the rollover date the point after which new memberships are entered as belonging to the next 
dues period. 

Membership can be inherited from one contact to another which is useful in situations like 
professional trade organisations where the organisation is the member, but employees of the 
organisation receive the benefits of membership. Use the relationships dropdown to specify 
which related records should receive membership through the parent record. 

You can restrict certain membership types (e.g. honorary, lifetime) so they can only be 
accessed by administrators and are not available to membership signup or renewal pages on 
your website, but are only to be managed by administrators. Use the visibility option to 
control who is able to access the membership type. 

At the bottom of the membership types page you will find a block of information for managing 
renewal reminders. CiviCRM can be configured to send out a reminder email to members as 
the expiration date for their membership nears. This is particularly helpful for rolling 
membership types where contacts may join at any time during the year. To configure the 
renewal reminder you must first have setup a renewal email template through Administer 
CiviCRM » Message Templates. 

The Atlantis State Public Transit Association (ASPTA) is useful as a case study for thinking 
about how to apply memberships. 



ASPT 



Case Study 




The Atlantis State Public Transit Association (ASPTA) has four membership categories it must 
configure in CiviCRM: 



• Regular Members: Public transit systems. There are three tiered dues levels within this 
category, based on the size of the system. Membership is organization-based, and all 
employees receive access to member benefits, such as discounted rates at Association 
events. 

• Affiliate Members: Businesses providing goods and services to the transit industry, 
such as bus and rail car manufacturers, engineers and consultants, parts and component 
manufacturers, etc. Membership dues are a flat rate for all Affiliate Members. 
Membership is organization-based, and all employees receive access to member 
benefits, such as discounted rates at Association events. 

• Associate Members: Students, government representatives, public interest groups, 
research institutions, and other interested parties. Membership dues are a flat rate for 
all Associate Members. Membership is individual-based. 

• Honorary Members: Retired transit system executives and others who have made a 
notable contribution to the industry and Association. No membership dues; lifetime 
period. Membership is individual-based. 

As the ASPTA CiviCRM administrator configures the membership types, she creates three 
separate types for the Regular Member category to account for the three dues levels. The 
duration is one year, beginning on January 1, with a rollover date of October 1. In this way she 
accounts for new members who join very late in the year and are not able to fully benefit 
from their membership — the membership extends through December 31 the following year. 

In the relationship type dropdown she selects "employer of." All employees of regular member 
organizations are allowed to attend the annual conferences and training programs at the 
member rate, and receive mailings from the Association through their inherited membership. 
The Affiliate Member category is configured in a similar way. 

Associate Members are people, not organizations, so the configuration is similar with the 
exception that no option is chosen for the relationship type dropdown. 

Note that CiviCRM does not have the ability to connect a membership type to a specific 
contact type (individual, organization, or household). While we have structured the membership 
types according to the ASPTA category definitions, it will be important to train staff to enter 
records with the appropriate contact record (Regular and Affiliate with the organization; 
Associate and Honorary with the individual). 

The last membership category is a little different than the previous. It is awarded to those 
who have retired from the industry and are recognized for their contributions to the 
organization. Membership is defined as rolling (beginning on the date of retirement), lasting for 
1 lifetime (no expiration date), and it is not available to public access pages (only administrators 
can assign the membership to an individual). 

CONFIGURING MEMBERSHIP STATUS RULES 

Having completed the configuration of the organization's membership types, you must now 
define the membership status rules. These are handled in: Administer CiviCRM » 
CiviMember » Membership Status Rules ( Drupal: 

http : / /siteu rl/civicrm/admin /member/member ships tatus?re set =1 ). 

At any point in time, your members will have a status identified for each membership record. 
The status provides information about the record, for example if it is current, new, expired, or 
in a grace period. Generally those status types are measured from the start or end date of 
the membership record. 

CiviCRM will check the status rules for a membership record and update it accordingly when 
you create or edit the record. In order to take full advantage of the membership status rules, 
and to automatically send membership renewal emails you must configure your server to 
regularly update the status of your members. This is done using CRON. For more details, 
visit the online documentation: 
http://wiki.civicrm.org/confluence/display/CRMDOC/Membership+Types . 



Membership rules are very powerful but can be involved to set up. At its most basic, 
membership rules are based on a start time and an end time. The start event indicates when 
the rule begins and the adjustment allows you to offset the start date. The end date works 
the same way, though it is not required. 

The current membership checkbox is an important way to determine whether a certain status 
is considered "current" when viewing the CiviMember summary statistics for memberships. In 
most cases, the New, Current, and Grace status types are considered current. 

When configuring the membership status rules, be sure to take note of the order in which 
they are listed. CiviCRM will process the rules beginning with the first and assign a status as 
soon as one matches. 

ASPTA is most interested in identifying new, current, grace, and expired members. The status 
rules defined by default when installing CiviCRM will largely meet their needs, with a few 
modifications. 

• New: The Association generally only sees a handful of new members each year. 
Consequently, effort is made to reach out to new members in a purposeful way and 
ensure they are quickly integrated into the organization. The organizations would like to 
define new members as those who have joined within the previous 10 months. The 
status rule was changed so that the end event adjustment was 10 months from the join 
date. 

• Current: The default status rule fits their needs — current members are those that fall 
within the start date and end date of their membership period. 

• Grace: Because so many of the organization's members are government entities (public 
transit systems) that traditionally have slower, bureaucratic systems when processing 
payments, ASPTA will extend the grace period to 4 months after the expiration date. 
Note, however, that the status rules are universal to all membership types. 

• Expired: The start event adjustment is altered to 4 months in order to coordinate with 
the grace period. Members who have not paid their dues will be considered current 
through the end of April, after which time they will be changed to the expired status and 
no longer benefit from membership discounts and mailings. 

Once you have completed the membership configuration, you can use CiviCRM to track your 
membership records. 
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MANAGING MEMBERS 



One of the greatest values CiviCRM offers is the ability to integrate an organization's 
administrative database with online forms in real time. No more duplicate data entry; no more 
convoluted efforts to synchronize multiple data sources; no more excuses to your Board of 
Directors and constituents — CiviCRM provides a single data repository for both administrators 
and online users. 

While this functionality is experienced throughout the CiviCRM tool set, one of the most useful 
ways this is seen is in the membership management tools. In this section we will discuss the 
tools available to administrators as they manage members. You will learn ways you can 
expose membership signup/renewal pages and membership directories to your members and 
other website visitors. 

ADMINISTERING MEMBERSHIPS 

Organization administrators will primarily work with membership records through the contact 
view. After finding the contact you wish to manage, click the Membership tab to view a 
summary of the contact's membership records. 
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Membership records will appear in a list with active memberships (those with a current status) 
first and expired or canceled memberships below. 

From this interface the administrator can edit existing membership records, renew a 
membership, or create a new membership record. If you have configured an online credit card 
payment processor for use in CiviCRM, you will see two options for creating or renewing a 
membership — one for handling an offline record (no real-time transaction taking place), and 
one for handling an online record (real-time credit card transaction takes place). The interface 
for each process is very similar, with the exception of the available payment processing and 
recording options. 

After choosing to create a new membership, you are taken to a form where you complete 
details regarding the record. 
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Many of the fields on this page will be auto-completed if left blank. This includes: 

• Source: The system will complete details regarding the record, including the fact that it 
was an offline or online transaction and who completed the record. 

• Join Date: The date the record was created will be auto-filled. 

• Start Date: If the membership type is a rolling membership, the current date will be 
auto-filled. If the membership type is a fixed period, CiviCRM will determine the 
appropriate start date based on the membership type configuration. 

• End Date: Calculated from the start date based on the membership type configuration 
settings. 

The status override field is used to manually define a status for the record. As indicated by 
the title, it overrides the automated status calculation. You should use caution with this field 
as setting it will disable the automated status function for the record. 

Recording Payments 

The Record Membership Payment checkbox expands the membership payment and receipt 
block and provides you an opportunity to record payments associated with the membership 
record. 

This also introduces an important concept central to CiviCRM's membership function. 
Membership records in CiviCRM are independent of, but can be related to, a financial 
transaction. While this may seem confusing to organizations accustomed to viewing 
membership records as essentially a financial transaction, it offers an important and valuable 
distinction. 

A membership record communicates the contact's relationship with the organization. A 
corresponding financial transaction indicates the monetary value associated with that 
relationship. While related, the two are distinct. The distinction is best understood by 
considering two scenarios: 



• Free memberships: It seems obvious that if you have a certain membership category 
that charges no fee, there would be no financial transaction associated with the 
membership. But in a traditional understanding (membership=financial transaction) this 
scenario "breaks" the model. 

• Membership renewal: If a member renews their membership, they are are essentially 
extending their existing membership record by another term, defined as the 
membership period. They are not creating a new membership, they are extending, or 
renewing an existing membership. By retaining a distinction between the membership 
record and financial transaction you can maintain a single membership record whose end 
date is extended, while creating multiple related financial transactions representing each 
renewal purchase. 

CiviCRM respects this distinction by recording the Membership record under the Membership 
tab, and the financial record under the Contributions tab, and then creating a link between the 
two records. 
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By clicking the Record Membership Payment checkbox and completing the transaction fields 
that are then displayed, you are building these two associated records. After recording the 
membership, you will be able to view the membership record and see the related contribution 
record at the bottom. 
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Renewing Memberships 

Naturally you expect your constituents to not only join your organization, but to maintain their 
membership on an ongoing basis through renewals. CiviCRM anticipates the renewal process 
and simplifies how that transaction takes place. 

Returning to the contact's membership tab you will see the option to renew an existing 
membership record. The renewal process does two things: 



It extends the membership record by altering the end date to reflect a new membership 
period. For example, if your organization's membership is handled on an annual basis 
from January through December, an existing end date of December 31, 2008 would be 
extended to December 31, 2009. CiviCRM calculates the end date extension based on 
the configuration for the specific membership type being renewed. 

If applicable, CiviCRM allows you to record a financial transaction (contribution) as part of 
the renewal process. As discussed earlier, this will insert a contribution record and 
attach it to the membership record. 



Compare the screenshot below with the one above. Note that the end date has been 
extended by one year, and there is a second contribution record listed below the membership 
details. 
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Because the renewal process is an extension of an existing membership record, CiviCRM locks 
certain fields related to the record, such as the join date and membership type. In addition to 
protecting against inadvertent data changes, it also helps to streamline the administrative 
process when recording renewals. If your constituent is moving from one membership type to 
another, you would need to create a new membership record, distinct from the existing one. 
In this way you develop a membership history for the member. 
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SIGNUP/RENEWAL PAGES 



Membership signup and renewal pages allow website visitors and existing users to manage 
their own membership. Membership signup and renewal pages can be connected with a 
financial contribution, which means you can use CiviCRM to process membership contributions. 

CiviCRM thinks of membership sign up pages as a type of Contribution Page (even if there is 
no associated contribution). So to create a sign up page, you need to create a contribution 
page- 
Select Manage Contribution Pages from the CiviContribute menu in the sidebar, or click 
Administer CiviCRM » Manage Contribution Pages. 

Manage Contribution Pages displays a list of existing contribution pages. To create a new 
page, click the New Contribution Page button. 

In this example, we will focus on some options in the contribution page setup wizard which are 
most likely to be used for a typical membership signup/renewal page. 




Case study 



The Atlantis State Public Transit Association's (ASPTA) Membership Committee would like to 
begin a focused outreach to non-member public transit systems (Regular Member category) 
and non-member businesses working in the public transit industry (Affiliate Member 
category). They also would like to allow their members to renew online and pay through a 
credit card. 

To accomplish this, they will create a membership signup/renewal contribution page. The 
membership join (signup) page will be available to all website visitors. The membership renewal 
page will be visible to members after they login to the members-only section. 

ASPTA has decided that it will not provide signup and renewal pages to Associate members at 
this time. 

1. Title and Settings 

Title and Settings is the first step in the contribution page setup wizard. An important 
setting affecting memberships is the Allow individuals to contribute and / or signup for 
membership on behalf of an organization checkbox. 

People (not organizations) visit websites, so CiviCRM assumes by default that any interaction is 
done through an individual's contact record. This becomes a problem if your membership 
categories are organization based. To address this, CiviCRM allows you to select this option 
and permit an individual to act on behalf of the organization they represent. The membership 
record will then be attached to the organization's record — not the individual's. After checking 
the box, you can add descriptive text and select whether the signup on behalf of an 
organization is optional or required. 
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2. Contribution Amounts 

The second step of the wizard allows you to configure details related to the financial 
transactions for the contribution page. If you have configured a credit card transaction 
payment processor in CiviCRM, you will be able to execute real-time transactions through this 
wizard page. 

In this example, we are building a contribution page for membership signup and renewal only, 
so we will uncheck the Contribution Amounts section enabled checkbox. (This hides the 
section which allows you to solicit extra financial contributions, in addition to the membership 

fee.) 

In addition to executing real-time transactions, you can allow constituents to make make 
offline payments through the Pay later option. The pay later tool is essentially a commitment 
on the part of the user to become a member and pay by check or cash at a later date. 
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3. Memberships 



The next step in the contribution page setup wizard is specifically related to memberships. 
Check the Membership Section Enabled checkbox to show two sets of title/introductory 
message fields, one for new memberships, and the other for membership renewals. 

CiviCRM will display the title and introductory message for new memberships if the website 
visitor is not logged in. If the user is logged in and has an existing membership record, then 
CiviCRM will display the title and introductory message for renewals. Joining the organization 
creates a new membership record, while renewing membership will update the member's 
existing record and extend their membership end date. 

Administrators should be aware of potential confusion and duplicate records if an existing 
member uses a membership join page without having first logged in. CiviCRM will make an 
attempt to match the user with an existing contact record, but any variations in the name or 
email address will cause a new contact record with corresponding membership record to be 
created. 

You may want to provide guidance in the introductory text on your membership join page to 
encourage members to login before completing the form. By logging in first, existing members 
can ensure that the transaction properly interacts with their contact and membership record. 

Toward the bottom of the Memberships wizard page are some additional options: 

• You can select which membership types are available to this signup/renewal page. 

• You can make membership signup required or optional. 

• If you enabled the option (in step 2 above) to solicit additional contributions, you can 
decide whether such payments are recorded separately from membership fee 
payments. 

• You can decide whether the membership fees displayed on the signup/renewal page. 

ASPTA selects the three Regular membership categories and the Affiliate category for display 
on this form, and leaves the default options unselected. This contribution page will only be 
used for membership signups, so membership type is set to be a required field. Fees will be 
displayed on the form for site visitors to view. 
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4. Thank-you and Receipting 

After the site visitor completes the membership signup or renewal form, they will be 
redirected to a thank-you page and can have an email receipt generated and sent to them. 
This fourth step in the wizard allows you to configure those options. 



5. Tell-A-Friend 



Organizational growth and development is increasingly built through viral social networking 
mechanisms. CiviCRM allows you to add a tell-a-friend feature to the thank-you page. The 
page lets your members share details about your organization with their friends by emailing 
them a link and information. 

6. Include Profiles 

The concept and usage of profiles is central to much of CiviCRM's interfacing with website 
visitors. In short, a profile is a collection of data fields that are used to obtain information 
from visitors or display data to visitors. If you are not familiar with the creation and function 
of profile sets you should read up on this. 

Profiles are critical to the effective function of membership signup and renewal pages. By 
default, contribution pages will only include an email field (required), in addition to the 
membership and contribution amount fields. Organizations almost always expect and require 
additional contact information to be collected as part of the membership signup process. On 
this sixth step of the contribution page wizard you may select an existing profile(s) for 
inclusion on the form. 

Forgot to define custom data fields or configure a profile before creating your 
membership contribution page? Don't worry — you can continue with the contribution page 
wizard and come back later to assign a profile to the page. 

7-9. Premiums, Campaign Widgets, Personal Campaign Pages 

Premiums are thank you gifts and incentives offered to organization contributors. They are 
most commonly associated with tiered donation levels, though they could be created for use 
with memberships. Before including premiums on a contribution page, you must configure 
them through Administer CiviCRM » Manage Premiums. Step 7 of the contribution page 
wizard controls the introductory text, contact information, and other premium-related details. 

Campaign widgets (Step 8) are used for displaying fundraising goals, and are not typically 
applicable to membership signup/renewal pages. 

The final step (Personal Campaign Pages) are also geared toward fundraising efforts and are 
not applicable to membership pages. 

Publishing your membership signup/renewal page 

After completing the contribution page wizard you return to the listing of pages where you will 
find the page you've just created. You can now view the page, test the functionality, or return 
to the configuration options and make adjustments. 

At this point you've completed the contribution page but have not made it visible or available 
to website visitors. Depending on the environment in which CiviCRM is operating, this will be 
accomplished in different ways. 

• Joomla!: The most direct way to expose your membership signup/renewal page to the 
front of your website is by creating a menu item. Navigate to a menu and create a new 
CiviCRM item. From the list of menu options choose Contributions. In the basic 
parameters section, select the contribution page you would like exposed from the 
dropdown menu. Save the menu item and view the website to confirm the page's 
functionality. 

• Drupal: From the contribution page listing, select "Live Page" to view the finished page. 
You can then copy the URL and include it in a content page or assign it to a menu item. 

• Standalone: From the contribution page listing, select "Live Page" to view the finished 
page and link to it. 

After completing configuration of their membership signup-renewal page, ASPTA creates a 
menu link to expose the form and begin their online membership recruitment effort. 
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SEARCHING AND REPORTING 

CiviCRM provides several tools to help you obtain a quick snapshot of your members and 
search through your members based on various criteria. From the main sidebar menu, select 
CiviMember to view the membership dashboard page. This page contains two blocks of 
information providing a summary of your membership categorized by type and date range, 
and a list of recent member activity. 
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All of the summary numbers are hot-linked, allowing you to drill down and view a list of 
members who have joined or renewed over the last two months, the year-to-date, or are 
considered current according to the membership status definitions. 

The Find Members page displays a series of searchable fields to help you segment and locate 
membership records. It is important to note that searching using this tool will display a list of 
membership records. So if a certain contact has multiple membership records meeting your 
search criteria, the contact will be duplicated as all their membership records will be displayed. 
This is in contrast to the advanced contact search tool which displays one row per contact (i.e. 
there would be no duplicate listed, even if a contact had two membership records meeting the 
search criteria). 

Toward the bottom half of the form are a series of date range fields. The left column 
indicates the From value and the right column the To value so you can narrow down searches 
to between two particular dates. If you are interested in membership records before a 
certain date, only use the to field. Conversely, if you are interested in membership records 
after a certain date, only select the from field. 

At the top of the search result set is a shaded block with tools to take action on all records in 
the result set or those selected using the checkboxes in the leftmost column. 
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The actions are as follows: 



Batch Update Members Via Profile: Use this option to edit multiple records in a table 
grid using a pre-defined profile. If you are not familiar with how profiles work, you will 
want to investigate how they are created before using this function. As you use this 
tool, note the following: 

o You must have a profile created before using this option. 

o Your selection of contacts must be of a single contact type. You cannot edit 
Individual and Organization type contacts simultaneously. 

o You may only edit a maximum of 100 records at a time. If your search result set 
exceeds 100, use the record selection checkboxes to edit a single page of records 
at a time. 
Delete Members: Delete their membership records from the database. Note: you are 
NOT deleting the contacts only their membership records. This action cannot be 
undone. 

Export Members: After selecting this action you will have the option of exporting a 
default set of primary fields or choosing which fields to export. When selecting which 
fields to export you may save the mapping for future use. The data is exported in CSV 
format and can be easily modified further in spreadsheet software or used for document 
mail merges. 

Send Email to Contacts: After searching your records, you may send an email to 
selected contacts and include data field tokens. Tokens are placeholders that are filled 
with the contact's data when the email is sent. This is incredibly valuable as you are able 
to send a bulk email to contacts while customizing it to each contact (e.g. beginning the 
email with a personalized salutation). 
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EMAIL COMMUNICATIONS 



The last decade has seen a remarkable shift in organizational communication methods away 
from postal mail and towards the use of the internet and broadcast email as a primary means 
of communicating with constituents. This reality is particularly true for non-profit organizations 
who have found email a faster, more effective, and lower cost way of communicating with 
their contacts. 

CiviCRM provides broadcast email capabilities through the CiviMail component. The central 
benefit CiviMail offers is the opportunity to manage your mailing contact list in conjunction with 
your contact database. Unlike other solutions, you do not have to transfer your mailing list 
from one system to another or manually update your primary contact database to reflect 
optout and unsubscribe requests. CiviCRM presents a unified solution toward contact email 
capabilities. 

METHODS OF SENDING EMAILS 

There are two ways to send emails using CiviCRM. 

1. Emails can be sent directly to a single individual or group of individuals collected through 
search results. Emails sent through the contacts screen or search screen are recorded in 
CiviCRM as activities and can be saved as templates. 

2. Emails can be sent through the CiviMail component tools. 

CIVIMAIL 

CiviMail is a more advanced way to send mass emails and should be used for larger scale 
mailings. The CiviMail tools will help you manage your mailing list by: allowing recipients to 
subscribe and unsubscribe; placing bounced emails on hold; providing ways for users to optout 
of mailings completely (in accordance with the United State's CAN-SPAM act). 

Using track-back mechanisms, CiviMail also provides feedback on how your emails are being 
used and whether they are received and opened. For example, if you send an email to your 
contacts and the email contains a link, you will be able to review how many people clicked the 
link to open it and who those people were. This is a tremendous value when trying to assess 
the success of your email marketing programs. 

The disadvantage of CiviMail over the simple contact and search based email function is that it 
requires more work for the initial configuration and requires more steps for sending out 
emails. 

ONote that CiviMail has specific server requirements that are necessary in order to 
take advantage of the full functionality. In some instances you may require 
professional assistance setting up CiviMail or you may find that the web hosting 
provider you are using does not meet the CiviMail configuration requirements. 
Please review the requirements and documentation online before attempting to 
setup the system: http://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+Configuration 

Setting up Email Templates 



Whether you are using simple contact and search-based email or CiviMail, there may be 
consistent layouts or content pieces that you wish to use repeatedly in your emails. For 
example: the Wellington Circus Trust often has people who have registered online for a class 
but who have not completed their registration by submitting payment. Some are simply slow 
in paying whereas others have changed their minds about taking the class. Obviously this 
makes it difficult to determine in advance how many people are going to attend the event. To 
address this, the organization sends out a standard email on a regular basis to all people with 
pending events registrations, requesting confirmation. This standard email is consistent from 
one event to the next. 

Rather than write that email every time they need to request confirmations, they have 
created it once and saved it as a template. To create or edit a template go to Administer 
CiviCRM » Message Templates. 
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Note that the message title is only for internal use (template selection) whereas the message 
subject is what the recipient sees. 

CiviMail will allow you to create both a text and an html-based message for your emails. 
Templates can contain both versions of the email or just one. Templates may also be created 
or updated at the time you prepare a new email. After developing your email content you 
have the option of saving the email as a template before you continue to the next step in the 
mail "wizard". 

Tokens 

You may notice in the screenshot above that the very first line contains text that is 
surrounded by curly brackets. Text that appears in this way is called a token. Tokens present 
one of the most valuable features in CiviCRM's mailing tools. A token represents a field 
(predefined or custom data) or action, and is replaced by the appropriate value at the time 
the email is sent out. The example above uses the first name contact token in the salutation. 
For each contact that the email is sent to, the token will be replaced with their first name. For 
example: if the email is sent to Richard Richards, the first line will read: "Hello Richard." There 
are dozens of tokens available and each has its own unique functionality. To view the list of 
available contact and action tokens visit: 

• http://wiki.civicrm.org/confluence/display/CRMDOC/Mail- 
merge+Tokens+for+Contact+Data 

• http://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+Action+Tokens 



Only contact fields and actions can be inserted in your email as a token. Related records, such 
as the name of the event that they have a pending enrollment for, cannot be included. 
However, you could provide a link to the person's contact dashboard so that they can review 
their registration details for themselves (once logged in). 

In most mailing interface pages the list of available tokens will be displayed above the mailing 
content block. Here, they can be inserted directly into the content by clicking the desired 
token. This greatly simplifies the token insertion process. 

The checksum token 

There is one contact token with unique qualities, the checksum token {contact. checksum}. 
The checksum token allows you to send an email to your constituents with a link to a 
contribution page or profile that has their contact information already filled in. This saves 
contacts the hassle of logging in or completing the form from scratch, and can increase the 
chance they would respond to the email by contributing or reviewing the details provided on 
the screen. 

To use this functionality, you will need to create a "special" link in the CiviMail message that 
includes the checksum token {contact. checksum}. When people click on the link it looks them 
up in the database and prefills any information on the contribution page or profile form with 
any data that exists in their record. The special link lasts for seven days from the time it was 
sent out. For more information on how to create links with checksum tokens, visit: 
http://wiki.civicrm.org/confluence/display/CRMDOC/Mail-merge+Tokens+for+Contact+Data 

Email Formats 

As noted earlier, the email content page includes one field for entering a text version of your 
message and another one for entering an HTML version. Which version is sent depends on the 
individual's preferences as configured in their contact summary screen. The relevant part of 
the screen is displayed below. 
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The default setting for email format is "Both", which means that the email that you send will 
use a multi-part mime type, and the email will contain the message content for both the text 
and html content fields. This also means that which version the recipient sees will depend on 
the settings they have chosen in their email client application. If the email format is set to 
HTML they will receive the email content you have entered in the HTML field. If you have not 
entered HTML content they will receive the content from the text field. 

Note, however, that if the contact's Email Format is set to "Text" and you leave the text 
content field blank, the contact will receive the html version of the email but it will not be 
displayed nicely. Their email client may display a lot of extra characters and information 
making it very hard to read. It is advisable to copy the content into the text version of the 
email unless you know it is not required. You should also think carefully before changing 
someone's email format to anything other than Both as this is usually the best setting. 

Writing HTML Emails 



Formatted emails are called html emails because they use the Hyper Text Markup Language 
for formatting. Fortunately you don't need to know HTML markup (unless you want to), as 
CiviCRM offers two WYSIWIG editors that use common toolbar buttons to control the layout. 
"WYSIWYG" stands for What You See Is What You Get and it is commonly used when 
referencing graphical editors that allow you to work with visually formatted text rather than 
the code that is actually used to achieve the formatting. The two WYSIWIG editors that are 
included with CiviCRM are called FCKEditor (the default) and TinyMCE. You can choose which 
one you want to use under Administer CiviCRM » Global Settings » Site Preferences. Both 
WYSIWIG editors are well-used Open Source Software and have their own websites and 
forums which you can consult if you wish to use advanced configurations such as replacing the 
default styles in the drop-down boxes with your own styles. 
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TinyMCE 

The interfaces of the two editors are pictured above. They are intended to be fairly self- 
explanatory and if you hover over a button information about what it does will appear. There 
are two buttons of particular interest in this environment: 

• E Paste from Word: Use this if you are copying and pasting from Microsoft Word. 
Though you may not be aware of it, MS Word uses hidden code to control the layout 
and styling on pages. When you copy and paste to the email layout editor, much of that 
code is copied over and can adversely affect the layout of your content. 

• .^ Maximise the Editor Size: Use this button to enlarge the editing window to the full 
screen size. This is particularly helpful when you are editing and laying out significant 
volumes of content. Click the button again to return to the mailing content page. 

SENDING SIMPLE EMAILS 

A simple email can be sent to an individual, a search result set, or to a group. In any of these 
cases, details of the email are added to both the sender's and recipient's activities tab record. 
This provides a valuable way of recording communications for future reference and/or for 
developing an audit record. 

Simple emails are generated in the following ways: 

• To send to an individual contact, click the "Send an Email" link on their contact tab. 
Note: if their record does not include an email address, this link will not appear. 

• To send to a search result set, first complete the search using one of the search tools. 
Select all records from the header bar or choose a subset of records using the 
checkboxes. From the actions dropdown select "Send Email to Contacts" and complete 
the email form. 

• To send to a group, first navigate to the Manage Groups page and select the "Members" 
link for the group of your choice. Select the records of your choice and use the action 
dropdown to "Send Email to Contacts." 



Note that the simple search tools are intended for low volume mailings, both because of the 
scalability of the sending mechanism and the way the emails are tracked for each contact in 
the system. Using the simple search for very large sets of emails may create unnecessary 
overhead on your server and add unnecessary records to your database. In addition and of 
equal importance, sending high volume emails via this method may cause your organization to 
wind up on an email "blacklist", which is definitely something to be avoided. 

CASE STUDY: Sending Email to contacts found in Search Results 

Wellington Circus Trust hosts several workshops for people interested in developing circus- 
related skills. People are allowed to register online with the option of paying later. 
Unfortunately, giving people this option often results in many registration records with pending 
status either because individuals often take their time submitting payment or they decide, 
after all, not to attend. 

Begin by navigating to the Find Participants menu option (CiviEvent » Find Participants), 

select "pending" from the Participant Status field, and click Search. 
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In this case, the search returns two contacts. You can either Send Email to contacts directly 
or if you plan on reusing the search result you can create a New Smart Group. For the sake of 
this case study we will simply initiate the mailing. 

After choosing "All 2 records" we will select "Send Email to Contacts" from the action 
dropdown and then proceed with creating and sending the email. 



Composing and sending the email 

The Send Email page is where you will construct the content of the email. Note the following: 

• If you have setup one or more FROM email addresses in Administer CiviCRM, you will 
have the option of selecting which which one will show up as the "From" adress on the 
email. By default, the Send dialog will use the email address of the administrator 
currently logged in. You may change this using the dropdown. 

• If you have previously created templates for use in mailings, a dropdown box will list the 
available templates. Selecting a template populates the text content and html content 
fields with the message content from the particular template you have chosen. You can 
then edit that content and resave if you so desire. 

• As discussed earlier, you can use the tools on this page to insert tokens into your email 
and develop content in both plain text and html format. 
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After completing this form, click send and the message will be sent immediately. 

PREPARING BROADCAST EMAIL IN CIVIMAIL 



CiviMail performs the same basic functions as the simple mail tools with the following 
additional features: 

• Scalability to manage large mailings. Some users of CiviCRM have mailing lists stretching 
to 100,000 records or more. 

• When defining the recipients of your mailing, CiviMail provides a very sophisticated 
mechanism for selecting or excluding groups, and selecting or excluding recipients from 
past mailings. This provides significant control over your mailing, but requires some work 
in advance. In particular, you must have created the group that will be your primary 
recipients list. 

• Techniques to prevent your emails from being treated as spam. 

• CiviMail has trackback capabilities, including the ability to track opens (did the recipient 
open the email in their email client) and to track click-throughs (did the recipient click 
links embedded in your content). This is a powerful way to monitor the success of your 
broadcast emails. 

• CiviMail will permit you to draft the email and its corresponding settings and save it for 
future review and sending. 

• Bounce processing capabilities will handle undeliverable emails automatically, flagging 
them in the contacts record with a "hold" value until administrative staff can confirm or 
correct the email address. You are also able to include unsubscribe and optout tokens in 
your email so that recipients can easily remove themselves from your mailing list or 
choose not to receive any emails from you at all. 

• Email content can either be uploaded from a file or created onscreen. This is particularly 
helpful when you are creating an email design that is complex and layout intensive. 

• CiviMail will allow you to configure and include headers and footers in your emails. 
Because broadcast email regulations in certain countries require the inclusion of the 
sender's mailing address and unsubscribe/optout links, the ability to define a footer can 
greatly facilitate how you meet these requirements. Simply configure the content to 
include the required fields and when developing your email content, include the footer. 

• CiviMail also provides the ability to schedule mailings for a specific date and time. 

When compared with the functionality and workflow of the simple mail tools, CiviMail is clearly 
more robust and complex. It is directed toward larger broadcast mailings where tracking, 
bounce handling, and more advanced recipient selections are required. 

As noted earlier, it is important to understand that CiviMail has certain server requirements 
and additional installation steps that must be completed before it can be used. This includes 
configuring bounced email processing and scheduling "cronjobs" on your server to trigger 
mailings. Please review these requirements thoroughly and consider seeking outside help if you 
are unable to complete the configuration steps. You can find more information here: 
http://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+lnstallation 

Configuring CiviMail Settings 

Before using CiviMail you must configure Mailer Settings and a Mail Account on the Administer 
CiviCRM page. 



• Mailer Settings: The mailer setting configuration controls the rate, batch size, and 
method details of your mailing process. The options are provided to accommodate 
server environments that may place restrictions on the number of emails sent per hour 
or the total number of emails that can be sent in a single instance. In many cases you 
can leave the default settings, but if you are not sure, you should contact your hosting 
company's support department (if you have one) to find out what restrictions, if any, 
they have placed on the system and how your settings should be configured to 
accommodate those limitations. 

o Mailer Spool Period: The number of seconds between delivery attempts for new 

outgoing mailings, 
o Mailer Batch Limit: The limit or "throttle" for email delivery as the maximum 

number of emails sent during each CiviMail run (0 = unlimited), 
o Mailer Spool Limit: The limit of emails sent via smtp mailer. If the limit is 

exceeded the emails are sent through the Spool table, 
o VERP Separator: Separator character used when CiviMail generates VERP 

(variable envelope return path) Mail-From addresses. 

• Mail Accounts: CiviMail provides the ability to automatically process bounced emails, 
replies, and to handle email-based subscribe/unsubscribe and optin/optout requests. To 
accomplish this you must setup a "Return Channel" solution. There are multiple return 
channel options available, as outlined in the online documentation 

( 

http://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+lnstallation#CiviMaillnstallation- 
SettingUptheReturnChannel) . The "standard" solution is php-based and involves creating 
a catchall email account that will be periodically polled and processed based on the 
bounce rules. There are several steps required in order to accomplish this, one of which 
involves configuring the mail account details through this interface. For full details on 
implementing this solution, visit the online documentation: 
http://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+Processor 

Note: After sending your first email using CiviMail, please monitor the process carefully using 
the mailing report tool. If you notice a significant number of bounces, it is likely that your 
server is rejecting emails because you have exceeded the maximum limits per hour. If this is 
so, you will need to adjust the mailer settings to limit how many emails are sent per hour, or 
how many are sent per batch. 

Also note that the Return Channel functionality is not a required feature. If you choose not to 
implement one of the Return Channel solutions you will continue to receive bounced emails, 
but they will not be processed by CiviCRM automatically. Also, if you do not configure a return 
channel, replies from the recipients CiviMail will not go to the sender of the mailing and will 
instead end up in your email domain's catchall account. You must also be sure to use the 
unsubscribe and optout url tokens — as opposed to the email tokens, as your system will not 
be able to process the emails unless a Return Channel solution is functioning. 

The CiviMail wizard 

We will now review the five step wizard used to create and send a new mailing and discuss the 
features on each page in more detail. 

1. Select Recipients 

CiviMail uses a series of include/exclude field sets to construct logic for the recipients list. The 
first pair of field sets is used to select groups that should be included, and groups that should 
be excluded, from the mailing. The second set of field sets is used to include and exclude 
contacts from previous mailings. The primary value of this logic-based layout is the ability to 
send mailings to contacts and exclude those that may have already received the mailing. 

For example, consider a situation in which you need volunteers to help with a fundraising 
event. You have already sent out an email to the contacts in your "Volunteers" group but 
having not received enough replies has prompted you to send an email to all newsletter 
subscribers. You don't, however, want to re-send the email to the Volunteers who have 
already received it, but a few people have been added to the volunteers mailing group since 
you last sent the email, and you do want them to receive it. 



Complicating the matter is the fact that there are a few people in your database who helped 
with last year's event but proved very difficult to work with. You've added them to a group 
called "Hard to Work With" and you would like to exclude them from the mailing to discourage 
their participation. Finally, you want to include contacts from the "Trustees" group, some of 
whom are not in the newsletter subscribers group. 

This fairly complex set of mailing recipient requirements can all be accomplished using the logic 
rules in CiviMail. 
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Note that the name of the mailing defined toward the top of this page is used for internal 
reference, and should be descriptive of the mailing. 

The CiviMail recipients selection mechanism is heavily dependent on groups. You will need to 
make sure your desired recipient list is defined in a group prior to initiating the mailing creation 
process. If you are not familiar with how regular and smart groups are defined and configured, 
please take time to research that further. 

When you create and configure groups, be sure to select "Mailing List" from the available 
Group Types list if you would like that group to be available to the CiviMail component. 

Group Type D Mailing List Q 

Using the recipient selection options shown above, someone who is in both the Trustees and 
the Newsletter Subscribers lists will only receive the e-mail once. If however, they are in a 
group that is excluded they will not receive any e-mails. Exclusions override inclusions, so 
Trustees and Newsletter Subscribers who received the Please Help with Our Annual Fundraiser 
email would be excluded from this follow-up mailing. 

If two different people are included in the mailing and they have the same email address the 
email will be sent twice to that email address. Any personalisations that you use (e.g. putting 
in the person's first name using a token) will be specific to each recipient. 



2. Track and Respond 



The second step in the mailing wizard controls tracking and response options. Tracking is the 
system whereby CiviCRM seeks to determine if the recipient has clicked any links included in 
the content of your email, and whether they opened the email on their computer. If you have 
enabled these two options in this second stage of the wizard, you will be able to view a report 
at the conclusion of your mailing in which summary details about your mailing are listed, 
including the number of click-throughs and tracked opens. A sample summary report is 
displayed below. 
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The summary report provides totals for each statistical category. The items in blue are hot- 
links which when clicked direct you to additional details about the statistics. The Tracked 
opens field gives you reasonable insight into what proportion of your audience read your email, 
but should not be viewed as a definitive measure. People who only read your email in their 
preview panel or who choose not to download images will not be recorded. Thus it is likely that 
the true number of people who read your email is probably more than that reported. 

Click-throughs refer to the number of times people have clicked on links embedded in your 
emails. The detail report breaks this down further for you into unique clicks (i.e. if one person 
clicks on one link more than once there are several click-throughs but only one unique click- 
through). The screenshot below is from a real mailing distributed by Wellington Circus Trust. As 
you can see from this report you receive more information about the success of your email 
communications if you adopt a strategy of including a teaser in your emails with a link to the 
full story. A teaser is an enticing introduction to a topic with a link to read more about it on 
your website. 
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Additional details about the specific contact person are also included in this report. 

The Responding section of the second wizard step provides options regarding reply 
forwarding, auto-respond, unsubscribe, resubscribe, and opt-out messages. 



Anyone who has managed a mailing list knows the significant challenges involved in maintaining 
an accurate and updated mailing list. There are several ways you can use mail-enabled groups 
in CiviCRM to ease the creation and management of mailing lists, and to configure CiviMail to 
automate the removal of contacts from mailing lists or completely opt-out of all mailings. 

Generally, if people do not wish to receive emails from you they can either Unsubscribe 
(remove themselves) from a specific mailing group or they can Opt-out to indicate that they 
don't want to receive any further emails from you. You enable them to do this by including 
action tokens in your mailings. 

The easiest way to accomplish this consistently is to create a footer that contains the 
necessary action tokens and can be included with your broadcast emails. Footers are handled 
through the Administer CiviCRM » Headers, Footers, and Automated Messages page. The 
footer should include either the opt-out URL or email, or the unsubscribe url or email. If you 
are using the URL formats, understand that the action token creates the actual URL value. 
For the HTML version of the footer you will want to use the HTML "<a href" tag to construct 
a hyperlinked text-friendly link to the opt-out and unsubscribe email or URL. 

Note: CiviMail requires the inclusion of the opt-out url or email token and the domain address 
token: 

• {action. optOut} or {action. optOutUrl} 

• {domain. address} 

Opt-out is the more powerful of the two mechanisms, as it indicates the user does not wish 
to receive any emails from you — not simply be removed from a certain mailing list group. 
CiviMail will never send emails to contacts who have chosen to opt-out (although you can send 
them simple emails if you wish). 

If someone has opted out of a mailing group (mailing list), their groups tab will show that they 
have removed themselves from the group. In this screenshot the person has unsubscribed 
from the group by email. 
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If a person Opts Out it will show up in the Communication Preferences of their Contact 
Summary Screen. 



Q communications preferences 

Privacy; NO BULK EMAILS (USER OPT OUT) Method: 

Email Format Preference: Both 



Whereas unsubscribe and opt-out actions are triggered by the contact, bounce holds are 
handled automatically by the system. A bounced email causes a hold to be placed on the 
contacts email address. The emails remain in your database but further emails will not be sent 
to them until the hold is released. Depending on the cause of the bounce failure, CiviCRM may 
place the hold on the email immediately (as in the case of an invalid email address) or it might 
record the failure and place the hold if the email address keeps failing (for example if the 
mailbox is full or it cannot reach the email domain; three failures of these potentially 
temporary kind will trigger the hold). It may be useful for you to create a smart group of 
contacts whose emails are on hold. That way, you can try to get their correct email address 
through other communication channels. 
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3. Mailing Content 

Having selected your recipients and configured tracking and response settings, the next step in 
constructing your mailing is to develop the content. The interface and options available are 
very similar to the simple email tools discussed earlier in this chapter, with a few important 
differences. 

CiviMail provides you with the flexibility to create your content on-screen using the WYSIWYG 
editor or to upload content from a file. The ability to upload content is important if you are 
developing an email that has more advanced styling or layout, and is more easily constructed 
in design software. 
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Another feature unique to the CiviMail tools, as introduced earlier, is the ability to select a 
pre-configured header and footer for the email. 
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Whether you are creating the content for the mailing using the editor or are uploading the 
content from a file, there are several things you should consider: 



• As a general rule, the layout and styling of your email content should be as simplified as 
possible. That does not mean you cannot create sidebar regions, header and footer 
regions, call-out boxes, and other layout features. But be conscious that you have no 
control over how your email will be viewed and what software will be used to display the 
email. Especially with the increased usage of web-based email and PDAs, emails must be 
formatted with a very broad-compatibility view in mind. 

• Though generally not desirable for website content, it is recommended that you use 
tables for layout rather than div tags. Many email clients still have difficulty accurately 
displaying div tags. 

• All CSS styling should be done inline. Unfortunately, email clients inconsistently interpret 
ess styles declared in the header. The only way to ensure your styles are preserved is 
to write them inline with the html tags. 

• CiviMail is not able to embed images in the body of the email itself. All images used in 
your emails must first be uploaded to your website and then referenced using the full 
URL of the image in the email. While requiring an extra step in the process, this 
requirement is actually to your advantage. Embedding images can significantly increase 
the size of your email. Referencing them remotely eliminates that size bloat. 

• CiviMail allows you to attach files to your email. The number of allowable files is 
configurable in Administer CiviCRM » Global Settings (three files is the default setting). 
However, avoid attaching multiple large files to your mass emails. Keep in mind that you 
are likely sending to a large number of contacts in your database. Even though CiviMail is 
built for large volume sending, the addition of files will bloat the size of the mailing and 
may slow down the delivery rate. If you have large files that you need to provide access 
to, upload them to your website first and then reference them in your email for 
downloading. 

Once you are satisfied with the email content click Next to advance to the fourth step in the 
wizard. Don't worry — you will be able to preview and test your email, and then return to this 
page to edit content if you need to. 

4. Test 

The fourth step in the email creation process is where you preview and test your mailing. 
Toward the bottom half of the page is a "Preview Mailing" block title which can be expanded 
to view the email content. The top half is where you can initiate test emails. The interface 
and options are very straightforward: you can either send to a single email address or to a 
predefined group. 

Testing the actual email — not simply previewing it — is a very important part of the mailing 
process. It is strongly recommended that you create a group that will be used for testing. The 
group should include email addresses representing one of each of the following different types 
of email environments, if possible: 

• Web-based email (GMail, Hotmail, Yahoo) 

• MS Outlook 

• Mac Mail 

• Mozilla Thunderbird 

• Text-only email 

Depending on your use of email and the nature of your constituents, you may also want to 
test emails on a PDA. 
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While it may seem tedious to test email in so many different environments and software, it is 
worth the effort to identify any layout and styling issues that are problematic in those 
different settings. You may find that once you've defined several well-formed templates and 
are more familiar with the use of CiviMail that testing on all of those environments is not 
necessary. But early in your use of the mailing functions it is worth the effort. 

As you test your email, you can seamlessly transition back and forth between the previous 
content-creation page and the preview/test page. Once you are finished with testing click Next 
to advance to the last stage in the mailing wizard. 

5. Schedule or Send 

The final step in your mailing process is to send the email immediately, or to schedule it for a 
date and time. The ability to schedule the mailing for a date and time is particularly helpful if 
you prefer to run the mailing during off-hours in order to limit impact on your server 
resources. 

If you are using scheduling to time delivery around a certain event, be aware of two things: 

• You may need to run some tests to confirm that the server date and time corresponds 
to the date and time of your location. 

• Be aware that when you schedule your mailing you are controlling when the mailing 
process begins. Depending on the size of your mailing list and the size of your email, it 
may take some time for the entire mailing to be processed. Additionally, depending on 
your mailer settings and how often your cronjob is run, you may have a delay in when 
the actual mailing process begins. In other words, just because you schedule the mailing 
for a specific time doesn't mean everyone will receive it at that precise time. 



Once you've completed these settings, select "Submit Mailing" to complete the process. 

CiviMail will display the mailing scheduled time, actual start time, and when it is completed. 
Once the mailing has started, you will see two actions that can be taken on the mailing: report 
and cancel. Selecting report will show you statistics for the mailing as outlined earlier in this 
section. Cancel will stop the mailing immediately. 

Reviewing Past, Scheduled, and Draft Mailings 

CiviMail maintains records for all past and scheduled mailings which can be viewed and 
searched for on the main CiviMail page or through the "Scheduled and Sent Mailings" submenu 
page. The main CiviMail page also includes unscheduled (incomplete) mailings. 

You may have noticed that on each page of the mailing wizard there is an option to Save and 
Continue Later. If at any time during the mailing preparation process you choose to stop with 
the intent of continuing later, you may click this button. CiviMail will save the mailing settings 
and allow you to continue the process at a later date by accessing the "Draft and Unscheduled 
Mailings" submenu page. 



If you become a heavy user of CiviMail you will quickly find the list of sent mails to grow quite 
long. The searching capabilities are useful for finding emails, but if you generate many emails 
with similar titles (such as "Newsletter") you may still find it difficult to locate specific mailings. 
CiviCRM provides the ability to archive sent mailings, removing them from the list of sent 
emails. Once archived you can access them through the Archived Mailings submenu page. 

Another commonly used feature is the ability to reuse mailings. From the list of completed 
mailings you will see a "Re-Use" option in the action list. Selecting this will create a copy of the 
mailing and allow you to walk through the wizard, editing it to suit your needs. 
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POSTAL MAIL COMMUNICATIONS 



It's often thought that in the 21st century there is no longer a need for old-fashioned snail 
mail. But you can't send everything over the internet, and if your constituents aren't online - 
or don't want to be - then postal mail is still an effective and crucial communication tool. 

This chapter discusses the different ways that CiviCRM helps with postal mail and post mail 
campaigns. You should have a strong understanding of CiviCRM's search features as well as 
custom fields, activities, profiles, and how to perform mail merges using word processing 
software. 

PLANNING YOUR MAILING 

Before beginning any communication program, take the time to identify goals and plan the 
process steps. For our purposes, there are a few key questions to ask before you sending out 
postal mailings. 

• What types of mailing do you send out to your constituents? Are mailings always sent to 
everyone in the database or are they frequently targeted to a select list of records? 

• Are you interested in tracking who receives your mailings? 

• How do you want to greet or salute recipients (e.g. Dear Jane)? 



Tracking 

For many organizations, its important to track the recipients of a mailing. Knowing who has 
been appealed to is a key part of your interaction with contacts. It is also useful for reporting 
success and return rates of a mailing used as part of a fundraising, membership development, 
or event promotion campaign. 

There are a couple of ways to track recipients of a mailing: 

• put all recipients of a mailing into a group and call it Spring Mailing 2009, for 
example. Then to track recipients all you need to do is run a search of who you want 
to receive the mailing and then add those recipients to a new or existing group. The 
downside to this approach is that in a very short time you will likely have group 
overload. Another reason you may not need to do this is that many times the recipients 
of the mailing include everyone in your database. If you add them to a group, it serves 
no real purpose as far as segmenting your data. 

• Use activities. Since a mailing is a type of interaction with your contacts, CiviCRM 
activity types are a great way to track recipients. If you have first created an activity 
type called "Mailing," you can run a search and add an activity record to everyone in the 
results list. That option is under the "More Actions" menu and is called Record activity 
for contacts. 
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Note: You may create additional activity types through Administer CiviCRM » Activity 
Types. 

TOOLS FOR MAILINGS 

CiviCRM provides two tools that are useful for creating mailings: export contacts and mailing 
labels. The Mailing labels tool is useful to quickly print out standard address labels when you 
don't need to personalize their content. Export contacts is useful for creating mail merges and 
when the standard mailing labels don't provide the information you need. 

Greetings and Salutations 

An important part of a postal mailing is including a salutation that is personable and friendly. 
Many people also prefer to be greeted in a special way if they are a doctor or esteemed 
person like a politician. Every individual record can have a prefix (Ms., Mrs., Mr., Dr., etc.), 
suffix, and a Greeting Type. 

Important: The greeting type field does not actually merge and export the data values for the 
selection (e.g. "Dear John"). Rather it exports the option selected (e.g. "Dear [first]"). It is only 
there to help you know how to perform the mail merge once your list is exported into a 
spreadsheet. Alternatively, if you select Customized Greeting under Greeting Type a new 
field appears where you can manually enter a greeting that will be exported and can be mail 
merged. 

There are other options for handling greetings that you should be aware of: 

• Nickname. To be consistent across contact types, it may be easier to always use the 
core nickname field as the greeting value since every contact type has that field. This 
eliminates the need to process multiple merge workflows based on the Greeting Type 
field. 

• Custom field(s). Some organizations may find it easier to create custom fields labeled 
Salutation (or Greeting) and Addressee. Salutation would serve as the universal field to 
greet all contacts and addressee will determine what appears on the actual envelope. 
This approach can be helpful for handling contacts who have special preferences with 
how you greet them in the letter (Dear Jack) and how they are addressed on the 
envelope itself (Dr. John Smith). 



MAILING TACTICS 



Once you have identified who your mailing recipients are, how you will track them, and how 
you are going to handle greetings and salutations, it is time to begin your mailing! 



Creating Your Mailing 

1. The first step is to run a search of who you intend to send the mailing to. Sometimes 
this may be your entire database. 

2. From the search results screen you will see a More Actions dropdown menu that allows 
you to, among other things, export the list as a CSV file. As you export to a 
spreadsheet, you can determine which fields you want to export to your spreadsheet 
and optionally save the list of exported fields as an export mapping template. Export 
templates are very useful if you run similar mailings very frequently and you have a 
defined set of fields you use every time. By default, CiviCRM will export a contact's 
name, contact information, email and phone, list of their groups and tags, current 
employer, and much more. 

3. Once your spreadsheet is created, you can do a mail merge using popular word 
processing software that will insert fields you want into the letter. For mailing labels, 
perform the same search as in step 1 above but under the More Actions menu, choose 
Mailing Labels (see the screenshot below). Then select the mailing label number, 
determine if you want to exclude people with "do not mail" checked in their privacy 
options (checked by default and recommended), and whether you want to merge two 
records in your search result with the same mailing address into one label. This last 
option is very useful when sending a mailing to a household or organization where you 
don't want them to receive duplicate mailings. When the records are merged, each name 
at that address is one line on the label. 
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TIP: many nonprofit organizations in the United States need to sort recipients of a mailing 
based on zip code for bulk mailing purposes. If this is true for your organization, it is 
recommended you do not create your mailing labels within CiviCRM and instead create them 
using a word processor where you can control the sort order. You can reuse the same 
spreadsheet for your mail merge you exported in step 2 above. 

Fundraising Mailings 



The steps above are useful for generalized mailings but many nonprofits have specific types of 
mailings such as thank you letters, renewal letters, and general fundraising appeals. The 
following tips and notes provide suggestions for how to handle those types of mailings. 



Thank-You Letters. Many organizations like to send personalized thank you letters to 
donors thanking them for their support. When doing so, it is often convenient to include 
a specific acknowledgement of the donor's contribution amount. For example, a letter 
would say, "Thank you Judy for your recent contribution of $35." In order to accomplish 
this you will need to create your list using CiviContribute because the results of a search 
using Find Contributions include amounts details. The results also include contact 
information so it can be easily used for mail merge purposes. 

Similar to thank you letters, renewal letters ask members and/or donors to renew 
their membership or previous donation level. In this case, it may be more useful to use 
CiviContribute to retrieve their last gift amount. 
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FREE SOFTWARE? 



CiviCRM is Free Software - this means it is developed by a community and licensed in a 
generous way so you can use it for free for whatever you want. 

Free Software (sometimes also referred to as Free and Open Source Software, FLOSS, 
FOSS, Software Libre, or Open Source) is software that anyone can download, share, and - 
- significantly -- change in any way they want. Practically speaking, you might never want to 
change the software, or even have a staff person who can read the source code (the 
instructions written by programmers). But the ability to change the software protects you in 
many ways: 

• CiviCRM will not go away, unlike non-free software from some companies that gets 
abandoned if the company goes bankrupt or decides to discontinue specific product. 

• The software can be used and customised free of charge. 

• Nobody can suddenly take away features or change the terms under which you're 
allowed to use features. 

• If an organisation wants a feature that CiviCRM doesn't provide, the organisation can 
just hire someone to create it. Of course, the organisation can also submit a feature 
request to the CiviCRM team as with any software product. 

• Similarly, anyone can fix a bug (error in the software) if he or she has the skills to do so. 
Because the source code is available, clients can also find bugs more easily. 

• Members of the community have much more input into how CiviCRM develops, because 
they can understand the product by reading the code and can make changes. 
Furthermore, many people can try different implementations of features and the 
community can decide by vote or consensus which one to make official. 

That may be enough for you, but for the sake of completeness we'll offer some widely used 
definitions: 

"Free software or software libre is software that can be used, studied, and modified without 
restriction, and which can be copied and redistributed in modified or unmodified form either 
without restriction, or with minimal restrictions only to ensure that further recipients can also 
do these things and that manufacturers of consumer-facing hardware allow user modifications 
to their hardware. Free software is available gratis (free of charge) in most cases." 
(from: http://en. wikipedia.org/wiki/Free_software ) 

"Open source software (OSS) is defined as computer software for which the source code 
and certain other rights normally reserved for copyright holders are provided under a software 
license that meets the Open Source Definition or that is in the public domain. This permits 
users to use, change, and improve the software, and to redistribute it in modified or 
unmodified forms. It is very often developed in a public, collaborative manner." 
(from: http://en.wikipedia.org/wiki/Open_source_software) 

Nearly any software that qualifies as free also qualifies as Open Source, and vice versa. The 
main reason that two different terms exist is that "free software" emphasizes the freedom 
aspect (that you aren't under the control of the original programmers) whereas "open source 
software" emphasizes the convenience and potential for innovation provided by having the 
source code available. 

When you install and use CiviCRM, you'll notice there's no annoying click-through software 
license imposing a thousand things that you can or cannot do with it. That's because free 
software doesn't limit your right to do with the software whatever you want. Free and open 
source software have licenses, but they're simpler than and quite different from proprietary 
software ('closed software') licenses. CiviCRM itself is available under Affero General Public 
License version 3.0, one of the popular free software licenses used by many other projects. 

FREE SOFTWARE AND NON-PROFITS 



Explaining all of the possible considerations on using FOSS in non-profit and advocacy work 
might take a really long time, so let's focus on the most important highlights: 

• One of the priorities of FOSS projects, including CiviCRM, is to involve the community of 
users in the process of designing and building the software. In the long run, this not only 
assures that the software is doing exactly what it should do to sustain the needs of its 
users, but it also allows indirect exchange of knowledge and experience between 
organisations. By using CiviCRM, you're basically taking advantage of other non-profit 
and advocacy practitioners' experience. 

• Having access to the source code gives you and your organisation certain independence. 
With proprietary software it's usually impossible to customise the tools to meet your 
specific needs. With FOSS, you can hire a developer or consultant and work with them 
on providing specific functionality needed in your work. Additionally, if you contribute 
your improvements to the project community other organisations will most probably 
start using them. It means you can receive testing and further improvements of your 
functionality. 

• When a company which provided you with a closed software goes out of business, the 
usual procedure for an organisation reliant on that software is to abandon the software 
and start investing in a new one (which is resource intensive and costly). It's less likely to 
happen with Free and Open Source Software - there is always a community of users 
and developers around it and there is no single "point of failure". With FOSS projects, if 
the main organisation behind a specific piece of software shuts down or changes their 
focus, the community takes over, a new organisation is formed and the software 
development and support continues. 

Apart from the quite practical advantages listed above, there is also a more philosophical 
approach to answering the question of importance of FOSS for non-profits and advocacy 
organisations. Without getting too deep into philosophical discussions, there is a great overlap 
between values shared by non-profit organisations and these shared by Free and Open Source 
Software communities. By working with the community of users, providing your feedback, 
contributing your changes back into the project, you're actually strengthening the non-profit 
sector. 

FURTHER READING 

Free Software Foundation 

http://www.fsf.org/ 

The Free Software Definition 

http://www.gnu.org/philosophy/free-sw.html 

Open Source Initiative 

http://www.opensource.org/ 

The Open Source Definition 

http://www.opensource.org/docs/osd 

GNU Affero General Public License v3 

http://www.opensource.org/licenses/agpl-v3.html 

Choosing and Using Free and Open Source Software: A primer for nonprofits 

http://www.nosi.net/projects/primer 
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BUG REPORTING 



There will be times when you use CiviCRM - as there are when you use any software - when 
things don't work the way you expect them to. 

When this happens, a good first step is to search the forums for similar problems and follow 
advice given there. If your problem hasn't been addressed, posting to the forum is probably 
the right thing to do. 

Have a look on the forum for good posting guidelines and spend a bit of time writing your post. 
Make sure you are detailed and specific about what software you are using, what you are 
trying to do and how you are trying to do it. For example letting people know the url you are 
using (with any confidential details removed) may cause them to realise that you are 
configuring the wrong page. Unclear posts are less likely to get good replies. 

WHAT CAUSES PROBLEMS WITH CIVICRM? 

Check the following possible sources of problems before you report something on a forum. You 
can save yourself and a lot of people trouble by isolating the problem. CiviCRM forums try to 
be friendly and don't criticise you for misjudging a problem, but you'll certainly get more help 
and resolve problems faster by doing some checking of your own first. 

• Misunderstanding the software. We don't claim our documentation is perfect. But 
please go back and check it very carefully when you hit a barrier. Frustration makes it 
hard to concentrate, so be sure to read slowly and thoroughly. Also remember that 
different parts of CiviCRM depend on each other, so check for problems in related 
modules, besides the one you think the problem is in. 

• Your server set up. Servers can be configured in many different ways, and these 
settings can change the way CiviCRM operates. Depending on your issue your server 
configuration may be causing you issues. 

• Customisations made to the source code of your installation of CiviCRM. Any changes 
made to the source code of CiviCRM may have unintended consequences. The 
community forums may be able to help you, but you will have to be patient, share 
source code, and try out suggestions. 

• Bugs in the version of CiviCRM you are using. After you have eliminated all the previous 
options, you can report your problem as a bug. In fact, we appreciate you doing this, 
because you are making CiviCRM better for everyone. 

RECREATING YOUR PROBLEM ON THE DEMO SITE 

Recreating your bug on one of the demo sites helps determine whether your problem is a 
result of a bug in the source code, or as a result of changes on your site, such as your server 
setup or any customisations you've made to the code. If you can show us that the code on 
the demo site turns up your bug, it's very likely that the CiviCRM source code is the problem, 
and your demonstration will help us find and fix it. 

Still, no demo site can cover all possibilities. So even if you can't reproduce your bug there, it 
might still be a bug in CiviCRM. It is, however, probably triggered by your server setup or other 
customisations. 

Write to the forum and explain the problem you are experiencing. If the bug was reproduced 
on the demo site, describe exactly what you did there. If not, include as much information 
about your server setup as you feasibly can. Configuration files from the web server, CMS, 
and CiviCRM will be valuable. 

If the forum suggests you discovered a bug in CiviCRM, you can report it to the CiviCRM bug 
tracker (http://issues.civicrm.org/iira/browse/CRM) . 

USING OLDER VERSIONS OF CIVICRM 



If you are using an older version and the problem you are experiencing is a bug that has been 
fixed in the lastest release, be prepared for the answer that it is time to upgrade to the latest 
version. Although the CiviCRM community tries to be as helpful as possible, and we recognize 
that upgrading puts a burden on your organisation, it is difficult to support multiple versions 
simultaneously. 

FIXING BUGS 

The amount of time taken for the bug to be fixed depends on the severity and complexity of 
the bug. It could be as quick as the same day, but it could take much longer. 

To get bug fixes, the easiest way is just to download and install the latest revision of CiviCRM. 
Downloading bug fixes between releases and fixing ('patching') your existing software is 
possible, but it's a more involved process and depends on your technical ability and server 
setup. 
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EXTENDING CIVICRM 



So you want do something that isn't currently possible in CiviCRM. The first question to ask 
yourself is: Are you sure it isn't possible ? CiviCRM is a sophisticated software package and 
much of its functionality isn't immediately obvious. It might be that CiviCRM can already do 
what you want it to. 

A great way of finding out whether something is supported is by writing - and getting feedback 
on - a use case. A use case is a story that documents the experience of performing a specific 
task. When you write a use case, avoid technical or database specific language like "field" or 
"record". Instead, concentrate on your real-world objects and scenarios. 

There are numerous ways to get feedback on your use case. Talk to other CiviCRM users, 
show them the use case and ask them how they would do it. Try talking to people in person, 
on the forum, or on IRC. 

Be flexible in how you think about your organisations processes, and how you use CiviCRM 
functionality. Maybe what you want can be done but in a different way to how you imagined 
you would do it. 

If your use case isn't satisfied with current CiviCRM functionality, it might be time to start 
creating it. 

GOOD PRACTICE FOR DEVELOPING WITH CIVICRM 

CiviCRM is open source and you can freely modify the source code. If you or someone you 
know has the knowledge, there is nothing to stop you downloading the code, modifying it, and 
running the new code at your organisation with little or know communication with the CiviCRM 
community. However, there are a few reasons why working like this isn't a great idea. The 
more you communicate with the community the higher the chances of success for your 
project. 

If you do change CiviCRM's source code, that is when it is most important to develop your 
code in co-ordination with the rest of the CiviCRM community. 

If you don't, then you'll find upgrades become cumbersome as you'll have to individually check 
and rewrite any customisations. That can be non-trivial, especially if you don't know 
understand the significance of the changes in the newest version. It's easy to say that you 
won't need any new features - that CiviCRM is feature rich enough for you - but what happens 
when the community has implemented new features that your clients would like, or has solved 
the same problem you solved? 

In contrast, if your changes are developed as part of the wider development process, the 
complex integration and testing work is done as part of the development process. And you'll 
benefit from the experience of the entire CiviCRM community in your developments. 

Another reason for developing in co-ordination with the CiviCRM community is that the more 
interaction you have with the community, the more you'll understand CiviCRM, the better you 
will be at using it, and the more you can guide its development. 

PLANNING NEW FUNCTIONALITY 

A clear and well thought out set of use cases for your organisation is a great starting point to 
developing new functionality, but you should go further and try to find a general solution that 
will be of use to many different organisations. Thinking more generally increases the 
likleyhood your ideas will be accepted into the core, and also helps you better understand your 
own needs. Disagreement and debate are a natural part of the planning process and will help 
ensure your functionality is implemented in the best possible way. 



Consider going on a publicity drive on the CiviCRM blog or forums, or talking directly to others 
you think would find the functionality useful. The interest and support of other organisations 
using CiviCRM will help drive your project forward. 

Also remember that the community is involved in a constant trade off between developing a 
product that 'can do everything' and ensuring the product is usable by everyone. Your very 
useful functionality might be seen as unecessary complexity for others. And even if the 
functionality can be turned on and off form a user perspective, it might still cause an extra 
layer of complexity 'under the hood'. 

THE DEVELOPMENT CYCLE 

CiviCRM follows a regular development cycle. Major version increments (for example the 
change from 2.3 to 2.4) happen roughly two or three times a year. Minor revisions (e.g. from 
2.3.2 to 2.3.3) happen as needed between releases. When developing code that is integrated 
into the core, you project will co-ordinate with this release cycle. Knowing when the major 
versions come out is useful when planning development projects. Check the CiviCRM web site 
for the release schedule. 

DEVELOPMENT METHODS 

CiviCRM uses a number of standardised methods to help people develop new functionality 
inlcuding an API and hooks. Detailed discussions of these methods is outside the scope of 
this text, but if you are considering custom development, you should be familiar with and use 
these tools. Changing actual CiviCRM core code should be a last resort. 

1. API: http://wiki.civicrm.org/confluence/display/CRMDOC/API-l-Overview 

2. Hooks: http://wiki.civicrm.org/confluence/display/CRMDOC/CiviCRM+hook+specification 

3. Custom templates and CSS: 

http://wiki. civicrm.org/conf luence/display/CRMDOC/Custom ize+Built- 
in.+Profile.+Contribution+and+Event+Registration+Screens 
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GLOSSARY 



ACL / ACCESS CONTROL LIST 

ACLs define permissions for a group of contacts to perform an operation (e.g. edit, view, 
delete...) on a set of data or a type of record. For example, you could set up a group 
"Administrators" that allows people to view and edit all contact records. Those in the 
"Volunteers" group can view contact records but can not edit them. 

ACCIDENTAL TECHIE 

Someone who has inherited the role of IT technical support but whose primary role maybe 
something else; often has little or no formal IT training (which is not always a bad thing!). 

AGPL - AFFERO GENERAL PUBLIC LICENSE VERSION 3.0 

A software license. CiviCRM uses this license - it gives you the right to do with the software as 
you like and guarantees the source code will always protect your rights in this way. 

ACTIVITIES 

An activity in CiviCRM is a record of any scheduled or completed interaction with one or more 
contacts. Examples include meetings, phone calls, emails, event attendances and contributions. 
You can define additional types of activities in CiviCRM as needed. 

ADMIN / ADMINISTRATOR 

The person or persons that maintain a server or a web-based software like CiviCRM. 
Administration includes maintenance, configuration, backup, security, creating and deleting 
user accounts etc. 

AGM 

Annual General Meeting. An AGM is generally held every year to inform members of previous 
and future activities. Certain types of organizations are required by law to hold an AGM. 

ALPHA VERSION 

A version of the software that contains very new source code with new functionality and bug 
fixes. Alpha versions are there for people wishing to see where the development is going, and 
for testing, but they are not considered to be any where near ready for general release or 
use. 

APACHE 

The most popular web server software. Apache is Free and Open Source. 

BACKUP 

Protecting your data by doing periodic copies and storing them independently of the original 
files so they can be restored if necessary. 

BANDWIDTH 



The speed at which you can transfer information through a network or internet connection. If 
a connection can transfer a lot of information it is said to be 'high bandwidth'. 

BETA VERSION 

A version of the software that is in good condition but still needs testing to make sure it 
functions as intended before general release. Testing beta versions is a helpful way to 
participate in the CiviCRM community. 

BLOG 

Short for web-log. A website which is updated with news and views from one or more 
individuals. 

BUG 

An error that prevents software from behaving as the user would expect. 

BUG REPORTING / BUG FIXING 

The process of reporting bugs to people that wrote the software, and then fixing the bugs so 
the software operates as intended. 

BUG TRACKER 

The official repository for recording bugs. http://issues.civicrm.org/iira/browse/CRM 

CAPTCHA 

see reCaptcha 

CACHE 

Cache is a recent copy of frequently used data. Data is cached so it can be quickly and easily 
accessed and is especially useful if the data is complicated or takes a large effort to 
generate. The disadvantage of cache is that they can often be out of date, though often this 
isn't a problem. Even caching data for 5 minutes might be useful in certain circumstances. If 
a page is accessed 1,000 times in 5 minutes, then having a cached version means the data will 
only need to be generated once. 

A Web cache holds copies of Web page files. 

CIVICASE 

The case management component of CiviCRM. CiviCase provides organizations which provide 
human services with tools for structuring, scheduling and recording case activities. 

CIVICONTRIBUTE 

CiviContribute is an online fundraising and donor management component which enables you to 
track and manage contributions to your organization. 

CIVICRM 

What this whole manual is about! CiviCRM is web-based, open source software that allows you 
to record and manage information about your various constituents including volunteers, 
activists, donors, employees, clients, vendors, etc. 



CIVIEVENT 

CiviEvent provides integrated online event registration and management for paid and free 
events. 

CIVIDOG 

See Scout. 

CIVIMAIL 

CiviMail is a mass-mailing component which allows you to engage constituents with 
personalized email blasts and newsletters. 

CMS 

Content Management System. A CMS is an application used to create, edit, manage, search 
and publish various kinds of digital content (text and other media such as pictures and videos). 
Web-based CMS allow organizations to add and manage content on their website without 
requiring advanced technical skills. CiviCRM is often integrated with a CMS (commonly Drupal 
andjoomla!) which helps you interact with clients. 

CRON JOB 

A cron job is a way of automatically scheduling a program to run at certain intervals. Crons 
are often used in CiviCRM to handle once a day, or once a month events like sending 
membership renewal reminders, processing ongoing payments, etc. 

CSS 

Cascading Style Sheets (CSS) are a way to define the style of a website by defining what 
tables headers, etc. to use. The advantage of CSS is that you only need to define the style 
once and it is repeated throughout the website. So you can change the style of a heading 
once and it will be repeated throughout the website. 

CSV 

Comma Separated Values. A simple format for a spreadsheet. CSV files are actually just text 
files where each cell is seperated by a comma, and each row is seperated with a return. CSV 
files are useful because they are a very simple format that many different programmes can 
understand. 

CLOSED SOFTWARE 

See proprietary software. 

CONSTITUENT 

See also Contact. A constituency is usually defined as a group of people bound by shared 
identity, goals, or loyalty. In CiviCRM, 'constituent' is used to broadly describe all of the 
supporters, potential and current of given organization. 

CONTACT 

See also Constituent. In CiviCRM a contact is either an individual, an organisation or a 
household. You can use CiviCRM to store information about contacts and their interactions 
with your organisation. 



CONTACT SUMMARY SCREEN 

The page that displays at a glance all the data about an individual, organization or household 
that's stored in the CiviCRM database. 

COMPONENT 

see module 

COMMA SEPARATED VALUES 

see CSV 

COMMUNITY ADVISORY GROUP 

A representative group of people from CiviCRM community who work with the CiviCRM team 
on project development. 

COOKIE 

A file stored on your computer that a website uses to identifiy you. Some Web sites cannot 
be used without accepting and storing a cookie. 

CORE CODE 

Also called core. The source code that constitutes the official code of CiviCRM. 

CORE DATA FIELD 

A field that is included in a record structure "out-of-the-box". For example, the CiviCRM 
contact record includes First Name as a core field. 

CORE TEAM 

The people most closely involved with CiviCRM development. 

CRM 

Constituent (or Customer or Contact) Relationship Management. CRM (or eCRM) software was 
originally developed to help companies track and organize their interactions with current and 
potential customers from a sales perspective. CiviCRM is oriented specifically toward the 
needs of non-profits, advocacy and non-governmental organizations, so the term "Customer" 
is replaced with "Constituent". Outside the US it is often referred to as Contact Relationship 
Management. 

CRUD 

Create, Read, Update and Delete. The basic functions performed on databases. 

CSV 

see comma separated values 

CUSTOM DATA FIELD 



A field that is added to the data structure of a CiviCRM record by your organization. Custom 
data fields extend the information that can be stored in that type of record. For example, 
your organization might need a custom field to record each contacts' ethnicity, or food 
preferences for an event attendence. 

DATA CENTRALISATION 

Storing all your data in one place. 

DEMO SITES 

A website that allows you to test and explore the functionality of a piece of software. CiviCRM 
maintains three demos sites; one integrated with Drupal, one integrated withjoomla! and one 
in standalone mode. 

DEDUPE 

dedupe refers to the task of finding and merging multiple entries for one contact. 

DEVELOPER 

Someone who develops software. 

DOMAIN 

see DNS 

DONOR 

Someone that makes a donation, i.e. voluntarily gives money. 

DNS (DOMAIN NAME SYSTEM) 

The Domain Name System (DNS) converts domain names, made up of easy-to-remember 
combinations of letters (example.com), to IP addresses (123.456.123.234) which are hard-to- 
remember strings of numbers. Every computer on the Internet has an unique address (a little 
bit like an area code+telephone number). 

DRUPAL 

A Content Management System (http://drupal.org) . 

ENCRYPTION 

A way of disguising data when it is being transferred from one computer to another so that it 
is unreadable by any computer that it may pass through on the way. 

ENVIRONMENT 

The specific hardware and software on which you are running your software. 

EVENT LISTING FEED 

A RSS feed containing the list of events defined in CiviEvent. 

FIREFOX 



Firefox is a popular free and open source web browser, developed by the Mozilla Foundation. 

FLOSS 

Free/Libre Open Source Software, licensed so as to guarantee the essential freedoms of 
software users to source code and reuse. A combination of Free Software and Open Source 
Software, with Libre added in to emphasize that software freedom is essentially a matter of 
rights, not price. 

FOSS 

Free and Open Source Software - see FLOSS. 

FORUM 

A web based tool to for discussions (see http://forum.civicrm.org/) . 

FREE SOFTWARE 

Software that is licensed so that you can use it, distribute, it, and change it without 
restriction. CiviCRM is Free Software. 

FTP (FILE TRANSFER PROTOCOL) 

The FTP protocol is used for file transfers. Many people use it for downloads; it can also be 
used to upload files to web servers. A popular free and open source FTP client for Windows is 
FileZilla. There are also some Web-based FTP clients that you can use with a normal Web 
browser like Firefox. 

FUNCTIONALITY 

The set of tasks that a piece of software can perform. 

GEOCODING 

The process of finding associated geographic coordinates (often expressed as latitude and 
longitude) from other geographic data, such as street addresses, or zip codes (postal codes). 

GRAPHICAL USER INTERFACE (GUI) 

User interface offering windows, icons, mouse control, multiple fonts, and so on. The opposite 
is a command line interface with only text. 

HOSTING SERVICE 

A service (usually a commercial service) that provides server space for your web site. Hosting 
services also can provide physical space to put your own server in so that it is connected to 
the internet. 

INTERNATIONALIZATION: I8N 

The process of making software ready for adoption in different countries and different 
cultures, without the need to modify it technically. Also see Localization 

INTERNET SERVICE PROVIDER (ISP) 

A business that provides services such as internet access, email, and website hosting. 



INTRANET 

A network of computers that are connected through a home or office but not accessible from 
outside the network. 

ICT 

Short for Information and Communication Technology. 

IT 

Short for Information Technology. 

JOOMLA! 

A Content Management System. ( http://www.ioomla.org ) 

LINUX 

A type of Operating System. Linux is popular as a web server but it is also gaining popularity 
on laptops and Desktop computers. Linux is Free Software. 

LOCALIZATION: LION 

The process of translating a product into different languages or adapting a language for a 
specific country or region. 

LOCAL COMPUTER 

A computer that runs CiviCRM but is not publicly available via the internet. This is often your 
personal or home computer or it can be in your office. 

MAIL SERVER 

A computer that transfers email from one computer to another. 

MAPPING PROVIDER 

A service provider that allows displaying contact locations on maps - Google Maps or Yahoo 
Maps in CiviCRM. 

MODULE 

A part of a system, also named as "component". CiviCRM includes a number of modules, each 
of which adds functionality to the basic contact management features. For example, the 
CiviEvent module provides event management functionality. Organizations using CiviCRM can 
turn modules on or off based on their needs. 

MYSQL 

A popular database engine. CiviCRM uses MySQL to hold its data. MySQL is Free Software. ( 
http://mysql.com) 

NGO 



Non-governmental organization. A legally constituted non-business organization with no 
participation or representation from government. In the United States, this type of 
organization is more often referred to as a Non-profit. They may be also called civil society 
organizations. 

NON-PROFIT 

see NGO 

NUMERONYM 

A word where the number is used to form an abbreviation 

ONLINE CONTRIBUTION PAGE 

A function of CiviCRM which allows creating a page on the website, which provides visitors 
with ability to make online donations using credit cards. 

OPEN ID 

OpenID is a free and easy way to use a single digital identity across the Internet. 

OPEN SOURCE 

See FLOSS 

PAYMENT INSTRUMENT 

Medium or Method that is used for payment. 

PAYMENT PROCESSOR 

A payment processor is a company (often a third party) appointed by a merchant to handle 
credit card transactions for merchant banks. 

PERMISSIONS 

Allow you to limit access for different users to different parts of the system. 

PERSONAL CAMPAIGN PAGES 

A feature that you can enable and allow your constituents to create their own fundraising 
pages. 

PHP 

The language in which the majority of CiviCRM is written. 

PING 

Sending and receiveing a small amounts of data to a server. Often used to measure the 
response time. 

POINT PERSON 

Someone given the responsibility to keep their eye on a certain issue. 



PREMIUM 

A gift that can be offered to contributor in exchange for donation. CiviCRM allows offering 
premiums as a part of the donation gathering process. 

PRICE SETS 

A way of storing and re-using complicated price structures for events. You can charge for 
different elements of an event. 

PRIMARY LOCATION 

The contact information that someone wants to use as their main point of contact. Used for 
mailings etc. 

PROFILES 

A central concept in CiviCRM. In essense a subset of fields. See Collecting and Sharing Data 
chapter for a full explanation. 

PROPRIETARY SOFTWARE 

Also called closed software. Software licensed so that you cannot access the source code 
and modify it without first coming to an agreement with the authors. 

RADIO BUTTON 

An element of web-based application user interface, allows you to choose only one of a 
predefined set of options. 

RECAPTCHA 

reCAPTCHA is a common way to test whether a user is a human or a computer. Useful to 
prevent spam. 

RICH TEXT EDITOR 

An editor that allows you to add formatting, like bold, italic and underline to text (as oppoosed 
to just plain text). 

ROOT DOMAIN 

The 'raw' URL of a website without 'www' or any other subdomain eg. (http://mysite.com is 
the root domain while http://www,mysite,com&nbsp: is not). 

RSS FEED 

RSS (Really Simple Syndication) is a way to publish frequently updated information, either for 
including on websites or being read by RSS readers. 

RSVP 

"Repondez s'il vous plait", a French phrase that translates to "please respond". Commonly 
used for request for confirming or declining attendance in the event. 

SENDMAIL 



Sendmail is one of the most popular mail transfer agents (MTA), software used for handling 
email on a server. Sendmail is Free and Open Source. 

SCRIPT 

A script is a short program that does one specific thing. Many Web pages include scripts to 
manage user interaction with a Web page, so that the server does not have to send a new 
page for each change. 

SCOUT 

The CiviCRM Book Sprint official dog. Scout likes dog biscuits, rolling on the ground, eating snow 
and proof-reading. 

SHARED HOSTING 

A website hosting service, where multiple websites reside on single computer. 

SERVER 

Usually used to refer to a computer connected to the internet that delivers (serves) web 
pages. Most computers can become servers. It just depends on how they are set up. 

SMART GROUP 

A group in CiviCRM to which contacts are automatically assigned. Smart groups are created 
by running a search and then saving the search. They are useful for groups that might change 
frequently, for example 'Expired members in Kenya'. 

SMTP 

Simple Mail Transfer Protocol. A standard used by email software to transfer (send) email. 

SOFTWARE 

Programs that enable specific functionality on your computer. There are many broad 
categories of software such as 'Web Browser', 'Word Processor' etc'. Within each category 
there are many available softwares that perform the functions you require. For example, 
Firefox and Internet Explorer are two softwares you may be familiar with, both of these 
examples are Web Browsers. 

SOFT CREDIT 

Allows you to credit a seperate contact for a donation that someone made. i.e. the person 
that inspired the actual donor to make a donation. See Personal Campaign Pages. 

SOFTWARE LICENSE 

The terms you must accept before using a piece of software. 

SOURCE CODE 

Software is created by writing instructions that a computer understands. These lines of 
instructions are known as code or source code. 



SSL (SECURE SOCKETS LAYER) 



SSL (or Secure Sockets Layer), is one way of making internet communication secure. You can 
easily see if you are using SSL by looking at the URL in your browser. If it starts with https 
instead of http, your connection is using SSL. 

SSL CERTIFICATE 

An SSL certificate is provided by the server to proove its identity, in the same way that a 
person carries a passport or driving license. See also SSL (Secure Sockets Layer). 

STABLE VERSION 

A version of the software that has been tested and is considered to be ready for general use. 

STANDALONE 

An installation of CiviCRM which is not integrated with a Content Management System (CMS) 
such as Drupal or Joomla!. 

STRING 

A string is a sequence of characters for example "Hello, World", the URL 
" http://www.flossmanuals.net/ ", and the text message "No such file or directory." Different 
character sets allow different strings. Unicode strings can include any combination of 
languages, such as "Japan (B^.) a nd Korea (tfl^tll^")". 

SUBDOMAIN 

A domain that is a part of larger larger domain. For example: crm.mysite.com is a subdomain 
of mysite.com domain. 

REQUIREMENTS 

The things that you require a particular application to do. 

TOKEN 

Tokens are used in CiviCRM to insert elements like name or greeting into emails being sent 
out. In the message sent out to a group of people, a token {first. name} will be replaced with 
actual names of each message recipient. 

UPGRADE 

When a new version of a software is available you may wish to replace your old version with 
the new one. (see also Version) 

URL 

Unique Resource Locator. The technical convention that identifies the location of a resource 
on a network. The 'resource' might be a web page, in which case the URL refers to the 
location of that webpage on the internet (eg. www.cnn.com is the URL for the CNN webpage). 

USE CASE 

A use case is a central concept in software development. Think of it as a story that 
documents the experience of performing a specific task. When writing a use case, avoid 
technical or database specific language like 'fields' or 'record', and instead concentrate on the 
real world objects and scenarios. 



VERSION 

Updates to software are released periodically, these releases are referred to as a version of 
the software. There are different applications of the term, for example the most recent 
release of a software which has been tested and is intended for general use is referred to as 
the stable version. 

VPN 

Virtual Private Network. A technical method of sharing information between members of an 
organisation over encrypted connections. 

WEB APPLICATION 

A software that provides a website which has functionality you require. CiviCRM is a web 
application. 

WEBMAIL 

Webmail is e-mail service through a Web site. The service sends and receives mail messages 
for users in the usual way, but provides a Web interface for reading and managing messages, 
as an alternative to running a mail client like Outlook Express or Thunderbird on the user's 
computer. For example a popular and free webmail service is https://mail.google.com/ 

WIKI 

A web based software that enables anyone to edit the content via a web browser. Wikipedia 
is the best known example of a wiki. 

WILDCARD 

A character that can match an any number and collection of characters. 

WORK STATION 

A computer used for working. 

WYSIWYG 

What You See Is What You Get. A visual tool for editing web content. See rich text editor. 
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ABOUT THIS MANUAL 



This manual was written during a 5 day Book Sprint organised by CiviCRM and led by FLOSS 
Manuals. The sprint was sponsored by the Information Program initiative of the Open Society 
Institute http://www.soros.org/initiatives/information) . We are especially grateful to Janet 
Haven for pushing this forward. 

Having secured sponsorship, the CiviCRM Core team invited a group of people from around the 
globe to gather for a week at Lake Tahoe in California. The modest goal was to transform our 
diverse experience of CiviCRM into a manual that we hope will help people to use this great 
piece of software. This turned out to be an interesting, and at times difficult, challenge. 

Here are the people that wrote this book. 




In the back row you are looking at Michael McAndrew (London, UK), Tony Guzman (Salt Lake 
City, USA), Brian Shaughnessy (Albany, NY, USA), Dave Greenberg (San Francisco, USA), 
Yashodha Chaku (Mumbai, India) and Adam Hyde (Berlin, Germany). In the front row Mari Tilos 
(San Francisco, USA), Cynthia Tarascio (Philadelphia, USA), Michal Mach (Warsaw, Poland) and 
Peter Davis (Wellington, New Zealand). In the very front is Eileen McNaughton (Wellington, New 
Zealand). 

We came from different backgrounds, had used CiviCRM in different ways, and had worked 
with very different organisations. It was often a challenge to meld these perspectives into a 
cohesive whole but we hammered away at it and we think this made for a better book. We 
had some lively discussions about important issues, such as whether there is a 'z' or an 's' in 
organis/zation or a 'q' in check/que, and finally agreed to use both spellings in the spirit of 
internationalism. We also struggled with the word 'constituent' which is core to the non-profit 
sector in America but was unfamiliar to those of us from outside America. 

It has been a pretty intense five days. Adam (our friendly Floss manuals taskmaster) has kept 
us realistic, on track, and hard at work - even hauling us back to work after dinner each 
evening. Overall it has been both fun and productive and we really appreciate the way Adam 
has helped us to actually produce a book within a week. Thank you. 



For most of us, however, the highlight of the week has been the breathtaking cuisine cooked 
by Jill Klein (http://www.partiesthatcook.com/about-us/) . We love you Jill and wish we could take 
you home with us. We are also grateful to Dave Greenberg, Bob Concannon and Mari Tilos for 
their hospitality, and to Scout the dog just for being there. 




We have had help from around the world during the preparation process, and over the course 
of the Sprint. Andy Oram has helped us both in the planning process and then with editing and 
feedback during the Sprint. We also had a number of people log in to write and edit the 
manual during the Sprint. They include Robert Santiago, Xavier Dutoit, Joe Murray, Sarmeesha 
Reddy, Jay Maechtlen, Dream Gomez, Leila Johnson, Duncan Hutty, and Kurundjalmi. 
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Our office for the week was Dave and Bob's house. 




We mitigated the hardship of late-night work with some tasty beverages. 




And occasionally they let us out for a bit.... 

HOW TO CONTRIBUTE TO THIS MANUAL 



If you would like to contribute then follow these steps: 



1. REGISTER 

Register at FLOSS Manuals: 
http://en.flossmanuals.net/register 



2. CONTRIBUTE! 



Select the manual http://en.flossmanuals.net/bin/view/CiviCRM/WebHome and a chapter to 
work on. 

If you need to ask us questions about how to contribute then join the chat room listed below 
and ask us! We look forward to your contribution! 

For more information on using FLOSS Manuals you may also wish to read our manual: 
http://en.flossmanuals.net/FLOSSManuals 

To help give our manual some continuity, we've come up with some agreed writing 
conventions . You should probably read this before contributing. 

3. CHAT 

It's a good idea to talk with us so we can help co-ordinate all contributions. We have a chat 
room embedded in the FLOSS Manuals website so you can use it in the browser. 

If you know how to use IRC you can connect to the following: 
server: irc.freenode.net 
channel: #booksprint 

4. MAILING LIST 

For discussing all things about FLOSS Manuals join our mailing list: 
http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net 
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I MANUALS 



Free manuals for free software 



GENERAL PUBLIC LICENSE 

Version 2, June 1991 

Copyright (C) 1989, 1991 Free Software Foundation, Inc. 
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA 

Everyone is permitted to copy and distribute verbatim copies 
of this license document, but changing it is not allowed. 

Preamble 



The licenses for most software are designed to take away your freedom to share and change 
it. By contrast, the GNU General Public License is intended to guarantee your freedom to 
share and change free software--to make sure the software is free for all its users. This 
General Public License applies to most of the Free Software Foundation's software and to any 
other program whose authors commit to using it. (Some other Free Software Foundation 
software is covered by the GNU Lesser General Public License instead.) You can apply it to 
your programs, too. 

When we speak of free software, we are referring to freedom, not price. Our General Public 
Licenses are designed to make sure that you have the freedom to distribute copies of free 
software (and charge for this service if you wish), that you receive source code or can get it if 
you want it, that you can change the software or use pieces of it in new free programs; and 
that you know you can do these things. 

To protect your rights, we need to make restrictions that forbid anyone to deny you these 
rights or to ask you to surrender the rights. These restrictions translate to certain 
responsibilities for you if you distribute copies of the software, or if you modify it. 

For example, if you distribute copies of such a program, whether gratis or for a fee, you must 
give the recipients all the rights that you have. You must make sure that they, too, receive or 
can get the source code. And you must show them these terms so they know their rights. 

We protect your rights with two steps: (1) copyright the software, and (2) offer you this license 
which gives you legal permission to copy, distribute and/or modify the software. 

Also, for each author's protection and ours, we want to make certain that everyone 
understands that there is no warranty for this free software. If the software is modified by 
someone else and passed on, we want its recipients to know that what they have is not the 
original, so that any problems introduced by others will not reflect on the original authors' 
reputations. 

Finally, any free program is threatened constantly by software patents. We wish to avoid the 
danger that redistributors of a free program will individually obtain patent licenses, in effect 
making the program proprietary. To prevent this, we have made it clear that any patent must 
be licensed for everyone's free use or not licensed at all. 

The precise terms and conditions for copying, distribution and modification follow. 

TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 

0. This License applies to any program or other work which contains a notice placed by the 
copyright holder saying it may be distributed under the terms of this General Public License. 
The "Program", below, refers to any such program or work, and a "work based on the 
Program" means either the Program or any derivative work under copyright law: that is to 
say, a work containing the Program or a portion of it, either verbatim or with modifications 
and/or translated into another language. (Hereinafter, translation is included without limitation 
in the term "modification".) Each licensee is addressed as "you". 

Activities other than copying, distribution and modification are not covered by this License; 
they are outside its scope. The act of running the Program is not restricted, and the output 
from the Program is covered only if its contents constitute a work based on the Program 
(independent of having been made by running the Program). Whether that is true depends on 
what the Program does. 

1. You may copy and distribute verbatim copies of the Program's source code as you receive 
it, in any medium, provided that you conspicuously and appropriately publish on each copy an 
appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer 
to this License and to the absence of any warranty; and give any other recipients of the 
Program a copy of this License along with the Program. 

You may charge a fee for the physical act of transferring a copy, and you may at your option 
offer warranty protection in exchange for a fee. 



2. You may modify your copy or copies of the Program or any portion of it, thus forming a 
work based on the Program, and copy and distribute such modifications or work under the 
terms of Section 1 above, provided that you also meet all of these conditions: 

a) You must cause the modified files to carry prominent notices stating that you 
changed the files and the date of any change. 

b) You must cause any work that you distribute or publish, that in whole or in part 
contains or is derived from the Program or any part thereof, to be licensed as a whole 
at no charge to all third parties under the terms of this License. 

c) If the modified program normally reads commands interactively when run, you must 
cause it, when started running for such interactive use in the most ordinary way, to 
print or display an announcement including an appropriate copyright notice and a notice 
that there is no warranty (or else, saying that you provide a warranty) and that users 
may redistribute the program under these conditions, and telling the user how to view a 
copy of this License. (Exception: if the Program itself is interactive but does not 
normally print such an announcement, your work based on the Program is not required 
to print an announcement.) 

These requirements apply to the modified work as a whole. If identifiable sections of that 
work are not derived from the Program, and can be reasonably considered independent and 
separate works in themselves, then this License, and its terms, do not apply to those sections 
when you distribute them as separate works. But when you distribute the same sections as 
part of a whole which is a work based on the Program, the distribution of the whole must be 
on the terms of this License, whose permissions for other licensees extend to the entire 
whole, and thus to each and every part regardless of who wrote it. 

Thus, it is not the intent of this section to claim rights or contest your rights to work written 
entirely by you; rather, the intent is to exercise the right to control the distribution of 
derivative or collective works based on the Program. 

In addition, mere aggregation of another work not based on the Program with the Program (or 
with a work based on the Program) on a volume of a storage or distribution medium does not 
bring the other work under the scope of this License. 

3. You may copy and distribute the Program (or a work based on it, under Section 2) in object 
code or executable form under the terms of Sections 1 and 2 above provided that you also do 
one of the following: 

a) Accompany it with the complete corresponding machine-readable source code, which 
must be distributed under the terms of Sections 1 and 2 above on a medium customarily 
used for software interchange; or, 

b) Accompany it with a written offer, valid for at least three years, to give any third 
party, for a charge no more than your cost of physically performing source distribution, 
a complete machine-readable copy of the corresponding source code, to be distributed 
under the terms of Sections 1 and 2 above on a medium customarily used for software 
interchange; or, 

c) Accompany it with the information you received as to the offer to distribute 
corresponding source code. (This alternative is allowed only for noncommercial 
distribution and only if you received the program in object code or executable form with 
such an offer, in accord with Subsection b above.) 



The source code for a work means the preferred form of the work for making modifications 
to it. For an executable work, complete source code means all the source code for all modules 
it contains, plus any associated interface definition files, plus the scripts used to control 
compilation and installation of the executable. However, as a special exception, the source 
code distributed need not include anything that is normally distributed (in either source or 
binary form) with the major components (compiler, kernel, and so on) of the operating system 
on which the executable runs, unless that component itself accompanies the executable. 

If distribution of executable or object code is made by offering access to copy from a 
designated place, then offering equivalent access to copy the source code from the same 
place counts as distribution of the source code, even though third parties are not compelled to 
copy the source along with the object code. 

4. You may not copy, modify, sublicense, or distribute the Program except as expressly 
provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute 
the Program is void, and will automatically terminate your rights under this License. However, 
parties who have received copies, or rights, from you under this License will not have their 
licenses terminated so long as such parties remain in full compliance. 

5. You are not required to accept this License, since you have not signed it. However, nothing 
else grants you permission to modify or distribute the Program or its derivative works. These 
actions are prohibited by law if you do not accept this License. Therefore, by modifying or 
distributing the Program (or any work based on the Program), you indicate your acceptance of 
this License to do so, and all its terms and conditions for copying, distributing or modifying the 
Program or works based on it. 

6. Each time you redistribute the Program (or any work based on the Program), the recipient 
automatically receives a license from the original licensor to copy, distribute or modify the 
Program subject to these terms and conditions. You may not impose any further restrictions 
on the recipients' exercise of the rights granted herein. You are not responsible for enforcing 
compliance by third parties to this License. 

7. If, as a consequence of a court judgment or allegation of patent infringement or for any 
other reason (not limited to patent issues), conditions are imposed on you (whether by court 
order, agreement or otherwise) that contradict the conditions of this License, they do not 
excuse you from the conditions of this License. If you cannot distribute so as to satisfy 
simultaneously your obligations under this License and any other pertinent obligations, then as 
a consequence you may not distribute the Program at all. For example, if a patent license 
would not permit royalty-free redistribution of the Program by all those who receive copies 
directly or indirectly through you, then the only way you could satisfy both it and this License 
would be to refrain entirely from distribution of the Program. 

If any portion of this section is held invalid or unenforceable under any particular 
circumstance, the balance of the section is intended to apply and the section as a whole is 
intended to apply in other circumstances. 

It is not the purpose of this section to induce you to infringe any patents or other property 
right claims or to contest validity of any such claims; this section has the sole purpose of 
protecting the integrity of the free software distribution system, which is implemented by 
public license practices. Many people have made generous contributions to the wide range of 
software distributed through that system in reliance on consistent application of that system; 
it is up to the author/donor to decide if he or she is willing to distribute software through any 
other system and a licensee cannot impose that choice. 

This section is intended to make thoroughly clear what is believed to be a consequence of the 
rest of this License. 

8. If the distribution and/or use of the Program is restricted in certain countries either by 
patents or by copyrighted interfaces, the original copyright holder who places the Program 
under this License may add an explicit geographical distribution limitation excluding those 
countries, so that distribution is permitted only in or among countries not thus excluded. In 
such case, this License incorporates the limitation as if written in the body of this License. 



9. The Free Software Foundation may publish revised and/or new versions of the General 
Public License from time to time. Such new versions will be similar in spirit to the present 
version, but may differ in detail to address new problems or concerns. 

Each version is given a distinguishing version number. If the Program specifies a version 
number of this License which applies to it and "any later version", you have the option of 
following the terms and conditions either of that version or of any later version published by 
the Free Software Foundation. If the Program does not specify a version number of this 
License, you may choose any version ever published by the Free Software Foundation. 

10. If you wish to incorporate parts of the Program into other free programs whose 
distribution conditions are different, write to the author to ask for permission. For software 
which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; 
we sometimes make exceptions for this. Our decision will be guided by the two goals of 
preserving the free status of all derivatives of our free software and of promoting the sharing 
and reuse of software generally. 

NO WARRANTY 

11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE 
PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE 
STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE 
PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND 
PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, 
YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 

12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL 
ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY 
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR 
INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA 
BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A 
FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH 
HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 

END OF TERMS AND CONDITIONS 



